Skip to main content
Version: 1.7.0

Check progress

For single searches​

  1. (RECOMMENDED) Use the webhooks/push notifications system. You can also assign a unique and custom webhook URL to each of your single search (see here). This is the most scalable way, as you do not have to care about rate limits.
  2. Fetch the results at a regular interval until the status of your search falls into one of the category that tells you the search is done.

For bulk searches​

  1. (RECOMMENDED) Use the webhooks/push notifications system. You can also assign a unique and custom webhook URL to each of your bulk search (see here). This is the most scalable way, as you do not have to care about rate limits.
  2. Fetch the results at a regular interval until the finished flag is true or the bulk appears in the status: "done" response. Then you can fetch individual results using the dedicated route.
caution

Be aware that we impose rate limits and you'll see 429 errors if you request this route too many times per minute.