Skip to main content
GET
List audiences API

Frequently asked questions

A saved group of domains you can profile, slice and monitor. It comes from one of two places: a list you upload, or a recipe we compute — company attributes (firmo), a technology expression (technology), or a saved adoption or churn query (signal). Whichever way it was made, every audience carries a materialized membership, so all the reporting endpoints work the same on all of them.
limit is how many audiences you may save: 2 on Free, 10 on Pro, 25 on Scale, 100 on Enterprise. member_limit is how large a single computed audience may build to: 1,000 on Free, 10,000 on Pro, 25,000 on Scale, 100,000 on Enterprise. Uploaded lists have their own separate caps of 100, 2,500, 10,000 and 100,000.
ready means membership is built and every reporting endpoint will work. uploading means a build is in progress. failed means the build errored — patch the audience with a definition or domains to retry.

Authorizations

Authorization
string
header
required

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

Response

Your audiences and plan limits

success
boolean
Example:

true

data
object