Refresh audience crawl API
Audiences
Refresh audience crawl API
Dispatch a one-off re-crawl of an audience’s members so their technology data refreshes now. 1 credit per dispatched domain; fresh domains are skipped free.
POST
Refresh audience crawl API
Frequently asked questions
What exactly am I paying for?
What exactly am I paying for?
Only domains actually dispatched to the crawler, at 1 credit each. Members scanned within the last 7 days are skipped as already fresh and cost nothing. Members beyond tonight’s fleet budget are deferred to a later night and also cost nothing. The response breaks all four numbers out.
When should I use this?
When should I use this?
When the technology report’s
freshness block shows the data is older than your decision needs. It is the on-demand counterpart to setting a crawl_cadence, which schedules the same thing repeatedly.Why did I get REFRESH_PENDING?
Why did I get REFRESH_PENDING?
The audience was dispatched within the last 24 hours and those crawls are still landing. Wait for them to arrive rather than paying twice for the same domains.
Is this available on the free plan?
Is this available on the free plan?
No. Crawl dispatch requires a paid plan, since it consumes real crawler capacity.
How long until the data updates?
How long until the data updates?
Dispatch is asynchronous — the endpoint returns as soon as the crawl requests are queued. Results land as the crawler works through them. Check the crawl history and the report’s freshness block to see progress.