Audience Profile

This article describes resources and services you can use to view audience profiles for the past 30 days.

Overview

Use audience profile to quickly understand demographic information including audience size, demographics, locations and devices for custom audiences. The Yahoo DSP automatically generates audience insights for the custom audiences you build.

Note

For privacy purposes, Yahoo DSP only generates audience insights for audiences with more than 1,000 users. Additionally, Yahoo DSP requires two days to gather enough history for the audience insights to be accurate.

You can view audience profiles through the following criteria.

Endpoint

View an audience profile.

GET /traffic/audiences/audienceprofile?segmentId={segmentId}

Parameters

Sample Request URL

GET https://dspapi.admanagerplus.yahoo.com/traffic/audiences/audienceprofile?segmentId=12345

Sample Response

{
  "response": {
    "audienceSize": [
      {
        "timestamp": "2019-10-27T00:00:00.000Z",
        "count": 231411
      },
      {
        "timestamp": "2019-10-28T00:00:00.000Z",
        "count": 201326
      }
    ],
    "age": [
      {
        "name": "13-17",
        "count": 52110,
        "uniqueCount": 34502
      },
      {
        "name": "18-24",
        "count": 82111,
        "uniqueCount": 42120
      },
      {
        "name": "25-34",
        "count": 91203,
        "uniqueCount": 43688
      },
      {
        "name": "35-44",
        "count": 78842,
        "uniqueCount": 43893
      },
      {
        "name": "45-54",
        "count": 49231,
        "uniqueCount": 18396
      },
      {
        "name": "55-64",
        "count": 18424,
        "uniqueCount": 8829
      },
      {
        "name": "65Plus",
        "count": 7821,
        "uniqueCount": 2194
      },
      {
        "name": "Unknown",
        "count": 49281,
        "uniqueCount": 22812
      }
    ],
    "device": [
      {
        "name": "Desktop",
        "count": 53210,
        "uniqueCount": 32845
      },
      {
        "name": "Phone",
        "count": 152336,
        "uniqueCount": 90132
      },
      {
        "name": "Tablet",
        "count": 10321,
        "uniqueCount": 8033
      },
      {
        "name": "ConnectedTV",
        "count": 1328,
        "uniqueCount": 653
      },
      {
        "name": "Other",
        "count": 74231,
        "uniqueCount": 44392
      }
    ],
    "gender": [
      {
        "name": "MALE",
        "count": 321872,
        "uniqueCount": 234212
      },
      {
        "name": "FEMALE",
        "count": 549910,
        "uniqueCount": 411927
      },
      {
        "name": "UNKNOWN",
        "count": 3024,
        "uniqueCount": 583
      }
    ],
    "location": [
      {
        "continent": "Asia",
        "countries": [
          {
            "name": "Singapore",
            "count": 3210,
            "uniqueCount": 883
          },
          {
            "name": "Korea",
            "count": 5323,
            "uniqueCount": 1737
          }
        ]
      },
      {
        "continent": "Africa",
        "countries": [
          {
            "name": "Lesotho",
            "count": 921,
            "uniqueCount": 533
          },
          {
            "name": "Ghana",
            "count": 1212,
            "uniqueCount": 835
          }
        ]
      }
    ]
  },
  "errors": null,
  "timeStamp": "2019-11-23T20:08:38Z"
}