Skip to main content
POST
Refresh audience crawl API

Frequently asked questions

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 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.
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.
No. Crawl dispatch requires a paid plan, since it consumes real crawler capacity.
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.

Authorizations

Authorization
string
header
required

API key in format tapi_live_[32-char] (live) or tapi_test_[32-char] (test)

Path Parameters

id
string
required

The audience id.

Example:

"seg_8f3a2c1b"

Response

Dispatch summary

success
boolean
Example:

true

data
object