Audience Details

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"
}