Documentation Index

Fetch the complete documentation index at: https://help.yahooinc.com/llms.txt

Use this file to discover all available pages before exploring further.

Audience Details

Prev Next

Get Audience Details by using the analytics endpoint to retrieve the size, demographic, device and location details of a given list of audiences.

Endpoint

/traffic/audiences/analytics

Use the following HTTP method:

  • Use the GET method to view details about the composition of a given list of Audience Segment Ids.

Parameters

Parameters

Parameter Type

Description

Data Type

Required/Optional

segmentIds

query

List of comma-separated Audience Segment Ids.

String

Required

Sample Request URL

GET https://dspapi.admanagerplus.yahoo.com/traffic/audiences/analytics?segmentIds={segmentId}

Sample Response

{
    "response": [
        {
            "segmentId": 1,
            "age": [
                {
                    "name": "13-17",
                    "count": 954139
                },...
            ],
            "gender": [
                {
                    "name": "UNKNOWN",
                    "count": 626194227
                },...
            ],
            "device": [
                {
                    "name": "Desktop",
                    "count": 1230320527
                },...
            ],
            "location": [
                {
                    "continent": "South America",
                    "countries": [
                        {
                            "name": "Colombia",
                            "count": 1847222
                        },...
                    ]
                },...
            ]
        },...
    ],
    "errors": null,
    "timeStamp": "2025-09-08T13:48:19.445Z"
}