Audience API

The Audience API provides aggregate demographic information about customer-defined collections of Twitter users.


Key features and core concepts.

API Reference

How to make a request to the API.

Interpreting Insights

Evaluating API results and user models.

Code Samples

Code samples to help you get started.

API Summary

The Audience API makes it possible to understand the aggregate demographic characteristics of any set of Twitter users. By understanding who is engaged with any topic, conversation, influencer or event, companies can make better product and marketing decisions, leading to increased brand affinity, revenue and ROI.

It’s now easier than ever to explore audiences of interest; in addition to building audiences with custom groups of Twitter users, you can now view audience insights about:

  • The followers of any public Twitter account.
  • A brand’s owned organic audience (reached and engaged).
  • A brand’s first-party data (via Tailored Audiences).

For any audience, you can retrieve aggregate demographic details across the following user models, built with both private and public signals: Gender, Interest, Language, Location, TV Genre, TV Show, Wireless Device Type and Wireless Carrier.

Change Log

  • [10/04/16] New! Added user age model to enable new types of analysis based on age.
  • [07/19/16] Added created_by notation in JSON response for both audiences and segments.
  • [07/19/16] Improved error messaging for organic audience segments with less than 500 users.
  • [07/12/16] General Availability (GA) Release!
  • [07/12/16] Support for 3 new methods of segment creation:
    • Followers of any @account
    • A brands’ own organic audiences (reached and engaged)
    • A brands’ own first party audiences (via Tailored Audiences)
  • [07/12/16] Audience API results rounded to the nearest 0.01%.
  • [07/12/16] Audience API results now describe users in an audience for whom we have demographic data, as opposed to the entire audience. See Interpreting Insights for more details.
  • [05/10/16] Removal of maximum reporting threshold; introduction of new minimum reporting threshold of 75 users per category (regardless of audience size)