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
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.Keep only stories about this, for example “funding and acquisitions”. Blank:
every story about the companies.
A stronger model rechecks borderline web pages for companies with little
coverage.
Make a company monitor of the run once it succeeds. See
Monitors.
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 abatch_id and the
run_ids of every part.
Story columns
A companies run returns one story per row. A story is a group of articles about the same event. Therows of the result and the CSV and Excel exports have
these columns:
Coverage per company
Besides the stories, a companies run returns one row per company incompanies, with what the agent found:
Each company has up to 20 minutes. A company that reaches that limit keeps the
stories found so far and shows
incomplete, and the run goes on with the other
companies.
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.
