Gnip Audience API Now Features Twitter Aggregate User Age Information

Twitter has announced that the Gnip Audience API can now retrieve Twitter aggregate user age information. The Gnip Audience API includes nearly one dozen demographic models including gender, interests, TV genre, TV show, language, location (country), and device category. User age is the newest addition to the set of Gnip Audience API demographic models.

The Gnip Audience API moved out of beta and was made generally available this past July. Developers can use the API to obtain demographic insights into sets of Twitter users. According to the announcement post, the Gnip Audience API can be used along with Gnip Full-Archive Search or Gnip PowerTrack APIs "to instantly understand the audiences engaged with any topic, conversation, influencer or event."

Brands and marketers can use audience data and demographic models to gain insights from compound queries. For example, a marketer could create a query that retrieves TV shows watched by specific age groups or interests for specific age groups. At the time of this writing, only two demographic "group-bys" are allowed per grouping in an API call e.g. "TV Shows by Age" would be valid, but a group-by with three demographic models such as "TV Shows by Age and by Gender" would not be allowed.

Here is an example of groupings that could be defined in a query:

"TV Shows by Age"

{
 "groupings": {
  "tv_shows_by_age": {
   "group_by": [
    "user.age",
    "user.tv.show "
   ]
  }
 }
}

It is possible to include more than one grouping in an API query, the maximum number of groupings per query is 10.

"TV Shows by Age and Gender"

{
 "groupings": {
  "tv_shows_by_age": {
   "group_by": [
    "user.age",
    "user.tv.show "
   ]
  },
  "by_gender": {
   "group_by": [
    "user.gender"
   ]
  }
 }
}

For more information about the Gnip Audience API, check out the API documentation.

Be sure to read the next Tweets article: Daily API RoundUp: Twitter, ABN AMRO, Naturalis Biodiversity

 

Comments (0)