Preview companies showing intent on a topic (free sample)

Free, capped preview of the account-discovery direction: given a topic_id, return a small sample (up to 25) of the top companies, ranked by people_count, plus count, the number of companies on the topic that match min_score and min_people_count. Use it to show a teaser while configuring a source, then call the paid /api/v1/intent/companies to pull and pay for the full list.

Nothing is billed. Distinct from dry_run (which returns a cost count and no records): this returns sample company rows. It does not paginate (no cursor, no next_cursor); you always get the strongest-intent top of the list. count is every company on the topic that matches the request's min_score and min_people_count, so the sample is only a window onto it. When min_people_count is above 1 and roughly 200,000 or more of the topic's companies have that many people, count is omitted.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Preview request for the topic->companies direction. Only the topic and floor filters are accepted: preview returns a hard-capped top-N sample and does not paginate, so page_size, cursor, and dry_run are not part of this request (any such fields sent are ignored).

string
required

The topic to preview companies for.

You can send a topic ID that was merged into another topic. The topic that replaced it answers. topic_id in the response keeps the ID you sent, and resolved_topic_id names the answering topic.

An ID the API cannot use never causes an error. It returns no results and adds an entry to the response warnings array.

string
enum

Minimum intent tier. high returns only high, medium returns high+medium, and omitting it or low returns all.

Allowed:
integer
≥ 0

Drop companies with fewer than this many distinct people of intent. 0 or omitted keeps all.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json