---
title: "Audience Explorer"
slug: "audience-explorer"
updated: 2026-02-12T20:12:05Z
published: 2026-02-12T20:12:05Z
canonical: "help.yahooinc.com/audience-explorer"
---

> ## 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 Explorer

Use Audience Explorer to retrieve a list of all audiences and their corresponding metadata.

## Endpoint

```plaintext
/traffic/audiences
```

Use the following HTTP method:

- Use the `GET` method to get a detailed view of all audience segment metadata.

### Parameters

| Parameters | Parameter Type | Description | Data Type | Required/Optional |
| --- | --- | --- | --- | --- |
| `page` | query | Page Number. | `Integer` | Optional |
| `limit` | query | Specifies the total number of items to return. Maximum allowed value is 100. | `Integer` | Optional |
| `sort` | query | Specify the column to sort by. | `String` | Optional |
| `accountId` | query | Specifies the advertiser ID. | `Long` | Optional |
| `dir` | query | Specifies the sort direction. Allowed values: - `ASC`: data is sorted in ascending order. - `DESC`: data is sorted in descending order. | `Enum` | Optional |
| `query` | query | Specifies the search term. Allowed variables: - `Name` - `Segment ID` | `String` | Optional |
| `keywords` | query | Comma-separated search strings that search against name and description. | `String` | Optional |
| `segmentType` | query | Specifies the segment type: - `COMPOSITE` - Specifies [Composite Audiences](/dsp-api/docs/composite). - `CONVERSIONRULE` - Specifies [Conversion Rule Audience](/dsp-api/docs/conversion-rule). - `CUSTOM` - Specifies [Device ID Audiences](/dsp-api/docs/custom-audiences). - `EMAIL` - Specifies [Email / Phone Number Audiences](/dsp-api/docs/custom-audiences). - `IPADDRESS` - Specifies [IP Address Audiences](/dsp-api/docs/custom-audiences). - `EVENTLEVEL` - Specifies [Purchase Receipt Audience](/dsp-api/docs/mail-event). - `FACT` - Specifies third-party Fact data segments. - `GEORETARGET` - Specifies [POI Audiences](/dsp-api/docs/point-of-interest). - `INTEREST` - Specifies Yahoo Interest Category segments. - `LOOKALIKE` - Specifies [Lookalike Audience](/dsp-api/docs/lookalike). - `MRT` - Specifies [Mail Domain Audiences](/dsp-api/docs/mail-domain). - `SRT` - Specifies [Search Keyword Audiences](/dsp-api/docs/search-keyword). - `HHL` - Specifies Household and Lifestages audiences. | `String` | Optional |
| `status` | query | The current status of the audience. Allowed values: - `ACTIVE`: the audience can be targeted. - `INACTIVE`: the audience cannot be targeted. | `String` | Optional |
| `startTime` | query | Return segments that are created/modified after this epoch time. | `Long` | Optional |
| `endTime` | query | Return segments that are created/modified before this epoch time. | `Long` | Optional |
| `currency` | query | Local currency id whether at Seat, Advertiser or Order level. | `String` | Optional |
| `timezoneId` | query | Target timezone. | `Integer` | Optional |
| `includeIabDataLabels` | query | If true, include IAB data labels in the response. | `Boolean` | Optional |

> [!NOTE]
> Note
> 
> When querying by `accountId`, the response includes all audiences linked to the advertiser, including those defined at the seat level.

### Sample Request

```plaintext
GET https://dspapi.admanagerplus.yahoo.com/traffic/audiences?segmentType={segmentType}&query={id}
```

### Sample Response

```json
{
    "response": [
        {
            "id": 123123,
            "status": "ACTIVE",
            "name": "Test LAL Build",
            "segmentType": "LOOKALIKE",
            "createdAt": "2025-10-24",
            "createdBy": "test@yahoo.com",
            "lastModifiedAt": "2025-10-24",
            "reachDetails": {
                "reachCount": 10983873,
                "peopleCount": 3234270,
                "houseHoldCount": 3728376,
                "activeReach": 8526902
            },
            "fees": [
                {
                    "fee": 0.5,
                    "suppressionFee": 0.0,
                    "mediaType": "VIDEO",
                    "channelType": "NATIVE",
                    "currencyCode": "USD"
                },
                {
                    "fee": 0.75,
                    "suppressionFee": 0.0,
                    "mediaType": "AUDIO",
                    "channelType": "DEFAULT",
                    "currencyCode": "USD"
                },
                {
                    "fee": 0.5,
                    "suppressionFee": 0.0,
                    "mediaType": "VIDEO",
                    "channelType": "DEFAULT",
                    "currencyCode": "USD"
                },
                {
                    "fee": 0.25,
                    "suppressionFee": 0.0,
                    "mediaType": "DISPLAY",
                    "channelType": "DEFAULT",
                    "currencyCode": "USD"
                },
                {
                    "fee": 0.75,
                    "suppressionFee": 0.0,
                    "mediaType": "VIDEO",
                    "channelType": "CONNECTEDTV",
                    "currencyCode": "USD"
                },
                {
                    "fee": 0.25,
                    "suppressionFee": 0.0,
                    "mediaType": "DISPLAY",
                    "channelType": "NATIVE",
                    "currencyCode": "USD"
                }
            ],
            "dataOwner": {
                "name": "Yahoo",
                "email": "test@yahoo.com",
                "domain": "https://yahooinc.com",
                "privacyPolicyUrl": "https://legal.yahoo.com/xw/en/yahoo/privacy/intl/index.html",
                "iabTechlabCompliant": false
            }
        }
    ],
    "errors": null,
    "timeStamp": "2025-11-10T23:47:33.642Z"
}
```