List audiences API
Audiences
List audiences API
List every saved audience on your API key, with your plan’s audience count limit and computed-member cap. Free.
GET
List audiences API
Frequently asked questions
What is an audience?
What is an audience?
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.What is the difference between limit and member_limit?
What is the difference between limit and member_limit?
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.What does status tell me?
What does status tell me?
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.