Overview
This endpoint allows you to monitor the progress of asynchronous jobs (including both discovery and publish jobs) for a specific market. Use it to check which steps have completed and the current progress of each job.Workflow Step: This endpoint is used throughout the Market Research
Workflow, including both discovery and publish phases.
Usage
Call this endpoint with themarketId
to get a list of all jobs and their statuses.
Best Practices
Polling Strategy: Check the status every 30-60 seconds
Authorizations
Pass a static API key for every request, provided by your customer support.
Path Parameters
Unique identifier for the market study.
Query Parameters
Filter by unique identifier for the job.
Filter by name of the service.
Available options:
first_pass
, second_pass
, manually_added
, enrichment
, scrape
, web_traffic
, momentum_scoring
, competitors
, news
, news_article_scrape
, search_esg
, extract_phrases
, embed_scrapes
, topic_analysis
, auto_feature_map
Filter by status of the job.
Available options:
pending
, running
, completed
Filter by timestamp indicating when the job started. Must be an ISO 8601 UTC string (e.g. 2023-01-01T12:00Z).
Filter by timestamp indicating when the job ended. Must be an ISO 8601 UTC string (e.g. 2023-01-01T12:00Z).