1
Set your connection
Run these commands in Bash. Enter the application origin from your account’s address bar, without
a trailing slash, then paste your key at the hidden prompt. The docs site is not the API host.
2
Find companies
This example looks for evidence relevant to someone selling charging equipment. Change the query
to describe the companies and activity you want to research.HTTP
202 means the search was accepted, not completed. Copy usage.id from the response.
An identical retry can return 200 if the search has already finished.3
Read the result
Enter the returned ID, then retrieve the operation:If the response is still
202, wait a few seconds before polling again. On success, inspect
companies, each company’s observations, and their evidence. A completed empty list is valid.
If error is present, read its code instead of treating it as an empty result.What you built
One company search with a reusable operation ID. Polling or retrying identical inputs with the same key does not start another search. A new search or next page needs a new idempotency key.Filter and paginate
Exclude customers you already know and inspect individual companies.
Read the evidence
Understand facts, possible demand, confidence, and coverage.
Troubleshooting
After a terminal failure or expiration, use a new key only when you intend to start another operation.
For help, share the usage ID and error code, never your API key.