Skip to main content
Send companies to POST /runs. The agent finds each company’s news stories in the window you set, optionally only the ones about a topic.

​
Parameters

​
object
required
The companies: list_id of a company list, or items, each with a domain (a URL works too) and an optional name. save_as_list: true also saves typed items as a list, named list_name.
​
string
Keep only stories about this, for example “funding and acquisitions”. Blank: every story about the companies.
​
integer
default:"30"
How many days back from today: 1 to 365.
​
boolean
default:"true"
Keep market activity stories: stock moves and analyst ratings.
​
boolean
default:"true"
Also read each company’s own newsroom and the web, not only the news.
​
boolean
default:"true"
A stronger model rechecks borderline web pages for companies with little coverage.
​
object
Make a company monitor of the run once it succeeds. See Monitors.
Company runs always use the standard mode.

​
Large lists

Free and pay-as-you-go runs take up to 50 companies. On Enterprise plans, a run of more than 50 companies is split into runs of up to 50, grouped in a batch. The response then has a batch_id and the run_ids of every part.

​
Coverage per company

Besides the stories, a companies run returns one row per company in companies, with what the agent found: Download it with GET /runs/{run_id}/companies.csv or companies.xlsx. If the run used a company list, fix a company with identity_unknown in the list: see Fix a company.