---
title: "Data Dictionary"
slug: "data-dictionary"
updated: 2026-04-08T20:59:01Z
published: 2026-04-08T20:59:01Z
canonical: "help.yahooinc.com/data-dictionary"
---

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

# Data Dictionary

*This article describes the data dictionary, a service that enables developers to identify supported values for common DSP Traffic API objects.*

## Overview

The data dictionary service allows you to get a list of the supported values for different DSP Traffic API object attributes.

## Dictionary Types

To get all of the supported dictionary types, make a `GET` call to the `/dictionary` endpoint.

The dictionary type values can be used in the URI in order to get a list of the supported values for those dictionary types. Note that more dictionary types may be added over time, in which case the array in the response will grow. The `GET` call required in order to retrieve this list will not change.

### Endpoint

```plaintext
/traffic/dictionary
```

The response returns an array of Dictionary types.

> [!NOTE]
> Note
> 
> Calling dictionary APIs do not count against any rate limits.

### Sample Response

```plaintext
{
  "response": [
    {
      "name": "Ad Sizes (Layouts) in an Ad object",
      "value": "layouts"
    },
    {
      "name": "MIME Types in an Ad object",
      "value": "mimeTypes"
    },
    {
      "name": "Creative Types in an Ad object",
      "value": "creativeTypes"
    },
    {
      "name": "Currency Types",
      "value": "currencyTypes"
    },
    {
      "name": "Languages",
      "value": "languages"
    },
    {
      "name": "Targeting Types",
      "value": "targetingTypes"
    },
    {
      "name": "Timezones",
      "value": "timezones"
    },
    {
      "name": "Ad Behavior Types",
      "value": "adBehaviorTypes"
    },
    {
      "name": "IAB Taxonomy Categories",
      "value": "iabTaxonomyCategories"
    }
  ],
  "errors": null,
  "timeStamp": "2023-01-30T18:03:29.048Z"
}
```

## Layouts

Get supported layout types for ads or creatives.

### Endpoint

```plaintext
GET /traffic/dictionary/layouts
```

#### Sample Response

```plaintext
{
  "response": [
    {
      "id": 78,
      "name": "0x0",
      "description": "Native Ad",
      "width": 0,
      "height": 0
    },
    {
      "id": 82,
      "name": "1x1",
      "description": "1x1 Ad Size",
      "width": 1,
      "height": 1
    }
  ],
  "errors": null,
  "timeStamp": "2017-04-12T04:49:06Z"
}
```

## Ad/Creative MIME Types

Get supported MIME types for ads or creatives.

### Endpoint

```plaintext
GET /traffic/dictionary/mimeTypes
```

#### Sample Response

```plaintext
{
  "response": [
    {
      "id": 0,
      "value": ""
    },
    {
      "id": 1,
      "value": "image/gif"
    },
    {
      "id": 2,
      "value": "image/jpeg"
    },
    {
      "id": 3,
      "value": "image/png"
    },
    {
      "id": 4,
      "value": "application/x-shockwave-flash"
    },
    {
      "id": 5,
      "value": "video/x-flv"
    },
    {
      "id": 6,
      "value": "video/x-ms-wmv"
    },
    {
      "id": 7,
      "value": "text/plain"
    },
    {
      "id": 8,
      "value": "text/html"
    },
    {
      "id": 9,
      "value": "text/javascript"
    },
    {
      "id": 10,
      "value": "application/javascript"
    },
    {
      "id": 11,
      "value": "video/mp4"
    },
    {
      "id": 12,
      "value": "video/webm"
    },
    {
      "id": 13,
      "value": "video/x-msvideo"
    },
    {
      "id": 14,
      "value": "video/quicktime"
    },
    {
      "id": 15,
      "value": "video/mpeg"
    },
    {
      "id": 16,
      "value": "video/ogg"
    },
    {
      "id": 17,
      "value": "video/x-ms-asf"
    },
    {
      "id": 18,
      "value": "video/3gpp"
    },
    {
      "id": 19,
      "value": "application/x-mpegURL"
    },
    {
      "id": 20,
      "value": "audio/mpeg"
    },
    {
      "id": 21,
      "value": "audio/ogg"
    },
    {
      "id": 22,
      "value": "audio/mp4"
    },
    {
      "id": 23,
      "value": "audio/webm"
    },
    {
      "id": 24,
      "value": "audio/vnd.wav"
    }
  ],
  "errors": null,
  "timeStamp": "2020-05-03T18:34:28.730Z"
}
```

## Creative Types

Get supported creative types.

### Endpoint

```plaintext
GET /traffic/dictionary/creativeTypes
```

#### Sample Response

```plaintext
{
  "response": [
    {
      "id": 1,
      "value": "STATIC_IMAGE"
    },
    {
      "id": 2,
      "value": "STATIC_HTML"
    },
    {
      "id": 3,
      "value": "DYNAMIC_IMAGE_TEXT"
    },
    {
      "id": 4,
      "value": "THIRD_PARTY"
    },
    {
      "id": 5,
      "value": "STATIC_VIDEO"
    },
    {
      "id": 6,
      "value": "NATIVE"
    },
    {
      "id": 7,
      "value": "NATIVE_VIDEO"
    },
    {
      "id": 8,
      "value": "AUDIO"
    }
  ],
  "errors": null,
  "timeStamp": "2020-05-03T19:19:35.954Z"
}
```

## Currency Types

Get supported currency types.

### Endpoint

```plaintext
GET /traffic/dictionary/currencyTypes
```

#### Sample Response

```plaintext
{
  "response": [
    {
      "id": 1,
      "code": "AED"
    },
    {
      "id": 7,
      "code": "ARS"
    },
    {
      "id": 8,
      "code": "AUD"
    },
    {
      "id": 20,
      "code": "BRL"
    },
    {
      "id": 26,
      "code": "CAD"
    },
    {
      "id": 28,
      "code": "CHF"
    },
    {
      "id": 43,
      "code": "EGP"
    },
    {
      "id": 46,
      "code": "EUR"
    },
    {
      "id": 49,
      "code": "GBP"
    },
    {
      "id": 58,
      "code": "HKD"
    },
    {
      "id": 63,
      "code": "IDR"
    },
    {
      "id": 66,
      "code": "INR"
    },
    {
      "id": 73,
      "code": "JPY"
    },
    {
      "id": 103,
      "code": "MXN"
    },
    {
      "id": 104,
      "code": "MYR"
    },
    {
      "id": 111,
      "code": "NZD"
    },
    {
      "id": 116,
      "code": "PHP"
    },
    {
      "id": 128,
      "code": "SEK"
    },
    {
      "id": 129,
      "code": "SGD"
    },
    {
      "id": 141,
      "code": "THB"
    },
    {
      "id": 149,
      "code": "TWD"
    },
    {
      "id": 153,
      "code": "USD"
    },
    {
      "id": 157,
      "code": "VND"
    },
    {
      "id": 170,
      "code": "ZAR"
    }
  ],
  "errors": null,
  "timeStamp": "2017-04-12T04:49:06Z"
}
```

## Languages

Get supported languages.

### Endpoint

```plaintext
GET /traffic/dictionary/languages
```

#### Sample Response

```plaintext
{
  "response": [
    {
      "id": 1,
      "value": "ENGLISH"
    },
    {
      "id": 3,
      "value": "SPANISH"
    },
    {
      "id": 8,
      "value": "FRENCH"
    },
    {
      "id": 2,
      "value": "CHINESE"
    },
    {
      "id": 4,
      "value": "JAPANESE"
    },
    {
      "id": 6,
      "value": "GERMAN"
    },
    {
      "id": 5,
      "value": "PORTUGUESE"
    },
    {
      "id": 7,
      "value": "ARABIC"
    },
    {
      "id": 9,
      "value": "RUSSIAN"
    },
    {
      "id": 13,
      "value": "ITALIAN"
    },
    {
      "id": 10,
      "value": "KOREAN"
    },
    {
      "id": 11,
      "value": "DUTCH"
    },
    {
      "id": 12,
      "value": "SWEDISH"
    },
    {
      "id": 14,
      "value": "INDONESIAN"
    },
    {
      "id": 0,
      "value": "UNKNOWN"
    },
    {
      "id": 47,
      "value": "POLISH"
    },
    {
      "id": 29,
      "value": "FINNISH"
    },
    {
      "id": 63,
      "value": "VIETNAMESE"
    },
    {
      "id": 43,
      "value": "MALAY"
    },
    {
      "id": 49,
      "value": "ROMANIAN"
    },
    {
      "id": 24,
      "value": "DANISH"
    },
    {
      "id": 23,
      "value": "CZECH"
    },
    {
      "id": 59,
      "value": "TURKISH"
    },
    {
      "id": 31,
      "value": "GREEK"
    },
    {
      "id": 58,
      "value": "THAI"
    },
    {
      "id": 52,
      "value": "SLOVAK"
    },
    {
      "id": 34,
      "value": "HINDI"
    },
    {
      "id": 20,
      "value": "BULGARIAN"
    },
    {
      "id": 46,
      "value": "NORWEGIAN"
    },
    {
      "id": 35,
      "value": "HUNGARIAN"
    },
    {
      "id": 100,
      "value": "TAGALOG"
    },
    {
      "id": 101,
      "value": "CHINESE_SIMPLIFIED"
    },
    {
      "id": 102,
      "value": "CHINESE_TRADITIONAL"
    }
  ],
  "errors": null,
  "timeStamp": "2020-05-03T19:21:31.141Z"
}
```

## Targeting Types

Get supported targeting types.

### Endpoint

```plaintext
GET /traffic/dictionary/targetingTypes
```

#### Sample Response

```plaintext
{
  "response": [
    {
      "id": 1,
      "value": "FREQUENCY_CAPPING"
    },
    {
      "id": 2,
      "value": "CONTEXTUALS"
    },
    {
      "id": 3,
      "value": "AD_POSITION"
    },
    {
      "id": 4,
      "value": "GEOGRAPHY"
    },
    {
      "id": 6,
      "value": "DEMOGRAPHIC"
    },
    {
      "id": 7,
      "value": "TECHNOLOGY"
    },
    {
      "id": 8,
      "value": "DAY_PARTING"
    },
    {
      "id": 9,
      "value": "SITE_LISTS"
    },
    {
      "id": 10,
      "value": "AB_TESTING"
    },
    {
      "id": 11,
      "value": "EXCHANGES"
    },
    {
      "id": 12,
      "value": "SEGMENT"
    },
    {
      "id": 13,
      "value": "TARGET_VIEWABILITY"
    },
    {
      "id": 14,
      "value": "PLAYER_SIZE"
    },
    {
      "id": 15,
      "value": "AD_INITIATION"
    },
    {
      "id": 16,
      "value": "CONNECTION"
    },
    {
      "id": 17,
      "value": "INTERESTS"
    },
    {
      "id": 18,
      "value": "GENDERS"
    },
    {
      "id": 19,
      "value": "LANGUAGES"
    },
    {
      "id": 20,
      "value": "SEAT_LEVEL_SITE_LISTS"
    },
    {
      "id": 21,
      "value": "BOT"
    },
    {
      "id": 22,
      "value": "DEVICE"
    },
    {
      "id": 23,
      "value": "SERVE_UNKNOWN_USER"
    },
    {
      "id": 24,
      "value": "VIEWABILITY"
    },
    {
      "id": 25,
      "value": "VIDEO_INVENTORY"
    },
    {
      "id": 26,
      "value": "INVENTORY_TYPE"
    },
    {
      "id": 27,
      "value": "ENHANCED_DAY_PARTING"
    },
    {
      "id": 28,
      "value": "PRIORITIZED_INVENTORY"
    },
    {
      "id": 29,
      "value": "MOBILE_PLACEMENT"
    },
    {
      "id": 30,
      "value": "WEATHER"
    },
    {
      "id": 31,
      "value": "CROSS_DEVICE_ID_ESCALATION"
    },
    {
      "id": 32,
      "value": "AUCTION_TYPE"
    },
    {
      "id": 33,
      "value": "NATIVE_LIST"
    },
    {
      "id": 34,
      "value": "SELLER_RELATIONSHIPS"
    },
    {
      "id": 36,
      "value": "VIDEO_CONTENT_LENGTH"
    },
    {
      "id": 37,
      "value": "VIDEO_PLACEMENT_TYPE"
    },
    {
      "id": 38,
      "value": "MOBILE_MEASUREMENT"
    },
    {
      "id": 43,
      "value": "AUDIENCE_ESCALATION_TYPE"
    }
  ],
  "errors": null,
  "timeStamp": "2020-05-03T19:50:26.893Z"
}
```

## Timezones

Get supported timezones.

### Endpoint

```plaintext
GET /traffic/dictionary/timezones
```

#### Sample Response

```plaintext
{
  "response": [
    {
      "id": 1,
      "abbreviation": "EST/EDT",
      "name": "Eastern Time",
      "tzId": "America/New_York"
    },
    {
      "id": 2,
      "abbreviation": "PST/PDT",
      "name": "Pacific Time",
      "tzId": "America/Los_Angeles"
    },
    {
      "id": 3,
      "abbreviation": "CST/CDT",
      "name": "Central Time",
      "tzId": "America/Chicago"
    },
    {
      "id": 4,
      "abbreviation": "AEST/AEDT",
      "name": "Australian Eastern Time",
      "tzId": "Australia/Sydney"
    },
    {
      "id": 5,
      "abbreviation": "AWST",
      "name": "Australian Western Time",
      "tzId": "Australia/Perth"
    },
    {
      "id": 6,
      "abbreviation": "WIB",
      "name": "Western Indonesian Time",
      "tzId": "Asia/Jakarta"
    },
    {
      "id": 7,
      "abbreviation": "JST",
      "name": "Japan Time",
      "tzId": "Asia/Tokyo"
    },
    {
      "id": 8,
      "abbreviation": "CST",
      "name": "China Time",
      "tzId": "Asia/Shanghai"
    },
    {
      "id": 9,
      "abbreviation": "GMT",
      "name": "Greenwich Mean Time",
      "tzId": "Etc/GMT"
    },
    {
      "id": 10,
      "abbreviation": "GMT/BST",
      "name": "London Time",
      "tzId": "Europe/London"
    },
    {
      "id": 11,
      "abbreviation": "IST/IDT",
      "name": "Israel Time",
      "tzId": "Asia/Jerusalem"
    },
    {
      "id": 12,
      "abbreviation": "CET/CEST",
      "name": "Central European Time",
      "tzId": "Europe/Paris"
    },
    {
      "id": 13,
      "abbreviation": "GST",
      "name": "Gulf Time",
      "tzId": "Asia/Dubai"
    },
    {
      "id": 14,
      "abbreviation": "NZST/NZDT",
      "name": "New Zealand Time",
      "tzId": "Pacific/Auckland"
    },
    {
      "id": 15,
      "abbreviation": "BDT",
      "name": "Bangladesh Time",
      "tzId": "Asia/Dhaka"
    },
    {
      "id": 16,
      "abbreviation": "AST/ADT",
      "name": "Atlantic Time",
      "tzId": "America/Halifax"
    },
    {
      "id": 17,
      "abbreviation": "CST",
      "name": "Central Standard Time",
      "tzId": "America/El_Salvador"
    },
    {
      "id": 18,
      "abbreviation": "PKT",
      "name": "Pakistan Standard Time",
      "tzId": "Asia/Karachi"
    },
    {
      "id": 19,
      "abbreviation": "BRT/BRST",
      "name": "Brasilia Time",
      "tzId": "America/Sao_Paulo"
    },
    {
      "id": 20,
      "abbreviation": "CST/CDT",
      "name": "Central Time",
      "tzId": "America/Mexico_City"
    },
    {
      "id": 21,
      "abbreviation": "ART",
      "name": "Argentina Time",
      "tzId": "America/Argentina/Buenos_Aires"
    },
    {
      "id": 22,
      "abbreviation": "COT",
      "name": "Colombia Time",
      "tzId": "America/Bogota"
    },
    {
      "id": 23,
      "abbreviation": "CLT/CLST",
      "name": "Chile Time",
      "tzId": "America/Santiago"
    },
    {
      "id": 24,
      "abbreviation": "PET",
      "name": "Peru Time",
      "tzId": "America/Lima"
    },
    {
      "id": 25,
      "abbreviation": "AST",
      "name": "Atlantic Standard Time",
      "tzId": "America/Puerto_Rico"
    },
    {
      "id": 26,
      "abbreviation": "MST/MDT",
      "name": "Mountain Time",
      "tzId": "America/Denver"
    }
  ],
  "errors": null,
  "timeStamp": "2017-04-12T04:49:06Z"
}
```

## Ad Behavior Types

Get supported ad behavior types for creatives.

> [!NOTE]
> Note
> 
> AdBehavior ids 1xx are for DISPLAY creatives and 2xx are for VIDEO creatives.

### Endpoint

```plaintext
GET /traffic/dictionary/adBehaviorTypes
```

#### Sample Response (Partial)

```plaintext
{
  "response": [
    {
      "id": 101,
      "value": "Billboard - Standard"
    },
    {
      "id": 102,
      "value": "Billboard - Interactive"
    }
  ],
  "errors": null,
  "timeStamp": "2018-01-03T00:29:47Z"
}
```

## IAB Taxonomy Categories

Get supported IAB Taxonomy Categories.

### Endpoint

```plaintext
GET /traffic/dictionary/iabTaxonomyCategories
```

### Response Fields

The response contains the following fields of interest:

| Name | Description |
| --- | --- |
| `id` | Unique ID of the category. This value will be used when creating an Advertiser. To learn more, refer to [Advertisers](/dsp-api/docs/advertisers). |
| `name` | IAB provided name for the category. |
| `description` | Category name. |
| `parentCategoryId` | ID of the parent category. For a top-level (PRIMARY) category, the value will always be 0. |
| `type` | Category type: - `PRIMARY`: Indicates a top-level category. - `SECONDARY`: Indicates a child category. |

#### Sample Response (Partial)

```plaintext
{
  "response": [
    {
      "id": 3,
      "name": "IAB3",
      "description": "Business",
      "parentCategoryId": 0,
      "type": "PRIMARY"
    },
    {
      "id": 304,
      "name": "IAB3-4",
      "description": "Business Software",
      "parentCategoryId": 3,
      "type": "SECONDARY"
    }
  ],
  "errors": null,
  "timeStamp": "2023-01-30T17:57:01.898Z"
}
```