Supply Lists

Use the sitelists endpoint to manage supply lists, which can include app lists, site lists and seller id lists, to allow or deny apps, sites (URLs) or seller ids for display, video and native lines.

• App lists - Lists of mobile apps.

• Site lists - Lists of websites.

• Seller ID lists - Lists of seller ids.

Create as many app lists, site lists and seller id lists for a single advertiser, or shared across all the advertisers in a seat.

Hierarchy

A supply list can be set at the seat level or the advertiser level.

• Seat-level app, site and seller id lists are shared by every advertiser in the seat.

• Advertiser-level app, site and seller id lists are specific to a single advertiser.

Endpoint

/traffic/sitelists

Use the following HTTP methods:

• Use the GET method to view an existing app list or site or seller id list.

• Use the POST method to create a new app list, site or seller id list.

• Use the PUT method to update an existing app list, site or seller id list.

Required and Supported Fields

Site List

The sitelists object contains the following fields.

Items

Each element in the items object contains the following fields:

Read a Supply List

Get data for a specific app, site or seller id list.

GET /traffic/sitelists/{id}

Parameters

Example Request URL

GET https://dspapi.admanagerplus.yahoo.com/traffic/sitelists/67358

Example Response

{
  "response": {
    "status": "ACTIVE",
    "type": "SITE_LIST",
    "id": 67358,
    "name": "test-site-list-1",
    "accountId": 1356341,
    "isShared": false,
    "updatedAt": "2017-09-22T05:45:36Z",
    "items": [
      {
        "id": 1992605,
        "itemName": "http://yahoo.com"
      }
    ]
  },
  "errors": null,
  "timeStamp": "2017-09-22T05:45:35Z"
}

Create a Supply List

Create a new app, site or seller id list.

POST /traffic/sitelists/

Parameters

All fields are specified in the body of the application/json payload.

Sample Request URL

POST https://dspapi.admanagerplus.yahoo.com/traffic/sitelists

Sample Request Body - Site List

{
  "accountId": 1356341,
  "name": "test-site-list-1",
  "status": "ACTIVE",
  "type": "SITE_LIST",
  "isShared": false,
  "items": [
    {
      "itemName": "http://yahoo.com"
    }
  ]
}

Sample Response - Site List

{
  "response": {
    "status": "ACTIVE",
    "type": "SITE_LIST",
    "id": 67358,
    "name": "test-site-list-1",
    "accountId": 1356341,
    "isShared": false,
    "updatedAt": "2017-09-22T05:45:36Z",
    "items": [
      {
        "id": 1992605,
        "itemName": "http://yahoo.com"
      }
    ]
  },
  "errors": null,
  "timeStamp": "2017-09-22T05:45:35Z"
}

Sample Request Body - Seller ID List

{
    "accountId": 75566,
    "name": "Seller List",
    "status": "ACTIVE",
    "type": "SELLER_ID_LIST",
    "isShared": false,
    "items": [
    {
      "itemName": "name-1",
      "exchangeName": "Direct Publishers"
    }
    ]
}

Sample Response - Seller ID List

{
    "response": {
        "id": 200741,
        "accountId": 75566,
        "name": "Seller List",
        "isShared": false,
        "updatedAt": "2025-09-12T16:38:01Z",
        "items": [
            {
                "itemName": "name-1",
                "publisherIds": [
                    140
                ]
            }
        ],
        "status": "ACTIVE",
        "type": "SELLER_ID_LIST"
    },
    "errors": null,
    "timeStamp": "2025-09-12T16:38:00.833Z"
}

Update a Supply List

Update an existing app, site or seller id list.

PUT /traffic/sitelists/{id}

Partial updates are supported; values of supported fields that are not in the payload remain unchanged.

Parameters

The Site List id is specified in the url path. All other fields are specified in the body of the application/json payload.

Sample Request URL

PUT https://dspapi.admanagerplus.yahoo.com/traffic/sitelists/67358

Sample Request Body

{
  "accountId": 1356341,
  "status": "ACTIVE",
  "type": "APP_LIST",
  "items": [
    {
      "itemName": "Angry Birds"
    }
  ]
}

Sample Response

{
  "response": {
    "status": "ACTIVE",
    "type": "APP_LIST",
    "id": 67358,
    "name": "test-site-list-1",
    "accountId": 1356341,
    "isShared": false,
    "updatedAt": "2017-09-22T05:50:57Z",
    "items": [
      {
        "id": 1992606,
        "itemName": "Angry Birds"
      }
    ]
  },
  "errors": null,
  "timeStamp": "2017-09-22T05:50:57Z"
}

Delete a Supply List

The DSP Traffic API does not support the deletion of app, site or seller id lists.