Advertiser

Abstract

Describes Yahoo DSP and Native GET Advertiser calls with endpoints, CURL and JSON example code.

Overview

A direct advertiser is a company that lists advertisements on DSP to purchase inventory provided by a range of publishers in the broader marketplace. A seat holder manages direct advertisers.

The action taken depends on the HTTP method and the parameters specified.

  • Use the GET method to read an existing advertiser.

  • Use the POST method to create a new advertiser.

  • Use the PUT method to update an existing advertiser.

GET Advertiser

Yahoo Native

Endpoint:

https://api.gemini.yahoo.com/v3/rest/advertiser

Method: GET

Header:

Content-Type: application/json Authorization: Bearer <access_token>

CURL

curl --location --request GET 'https://api.gemini.yahoo.com/v3/rest/advertiser/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer access_token ' \

Response

{
    "errors": null,
    "timestamp": "2021-02-13 6:21:33",
    "response": [
        {
            "lastUpdateDate": 1565915294000,
            "createdDate": 1447394066348,
            "managedBy": 1234,
            "bookingCountry": "US",
            "billingCountry": "US",
            "vatId": null,
            "webSiteUrl": null,
            "trackingUrl": null,
            "language": "en",
            "advertiserName": "ABC-12454",
            "type": "ADVERTISER",
            "currency": "USD",
            "timezone": "America/Denver",
            "status": "ACTIVE",
            "id": 45678,
            "budget": null,
            "budgetType": "NONE"
        }
              ]
      }

Yahoo DSP

Endpoint:

https://dspapi.admanagerplus.yahoo.com/traffic/advertisers

Method: GET

Header:

Content-Type: application/json X-Auth-Token: access_token X-Auth-Method: OAUTH2

CURL

curl --location --request GET 'https://dspapi.admanagerplus.yahoo.com/traffic/advertisers' \
--header 'X-Auth-Token: access_token ' \
--header 'X-Auth-Method: OAUTH2' \
--header 'Content-Type: application/json'

Response

{
    "response": [
        {
            "id": 12345,
            "name": " Test Advertiser",
            "landingPageUrl": "http://www.yahoo.com",
            "iabCategoryId": 15,
            "iabSecondaryCategoryId": 1508,
            "updatedAt": "2020-12-18T20:16:52Z",
            "billingPrice": 0.0,
            "isCrossdeviceOff": false,
            "status": "ACTIVE",
            "timezone": "America/Los_Angeles",
            "currency": "USD"
        }
]
}