Advertisers

  • 14 minute(s) read
Prev Next

This article describes services for reading, adding, and updating advertisers.

Overview

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

Endpoint

/traffic/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.

Resources

Advertiser Object

The advertisers resource is defined by the following following fields:

Name

Description

Type

Create

Update

id

Specifies the advertiser ID.

integer

N/A

Required

name

Specifies the name of the advertiser.

string

Required

Optional

status

Specifies the current status of the advertiser. Options include:

  • If ACTIVE, the advertiser is active.

  • If INACTIVE, the advertiser is inactive.

  • If ARCHIVED, the advertiser is archived.

string

Required

Optional

landingPageUrl

Specifies the advertiser’s website URL.

string

Required

Optional

iabCategoryId

Specifies the primary category of the advertiser’s business.

Use the id field from the IAB Taxonomy Categories response where the type field is set to PRIMARY.

integer

Required

Optional

iabSecondaryCategoryId

Specifies a secondary category of the advertiser’s business.

Use the id field from the IAB Taxonomy Categories response where the type field is set to SECONDARY.

integer

Optional

Optional

timezone

Specifies the default time zone for the advertiser’s data; the time zone used to aggregate advertiser data in reports.

Use the tzId field from the Timezones response. Some example values: America/New_York, Etc/GMT.

string

Required

N/A

currency

Specifies the default currency for the advertiser’s data.

Use the code field from the Currency Types response. For example, USD, CAD.

string

Required

N/A

billingPrice

Specifies the advertiser’s percentage profit margin expressed as a value between 0 and 100.

number

Required

Optional

contact

Specifies the advertiser’s primary contact information.

To learn more, refer to Contact Object.

object

Required

N/A

billingContact

Specifies the advertiser’s billing contact information. Billing contact fields are only included in the response for certain seats.

To learn more, refer to Billing Contact Object.

object

Optional

N/A

isCrossdeviceOff

Enable or disable the optimization using cross device conversions. By default, false.

  • If true, does not track cross-device conversions. For example, if you validate conversions with vendors that cannot track mobile conversions, you may want to disable cross-device conversions.

  • If false, tracks and reports on conversions that take place across multiple devices. For example, if an impression is served to a user’s mobile device, but that user ends up converting and completing a purchase for the advertised product on their desktop, it is considered a cross-device conversion.

boolean

Optional

Optional

createdAt

Read-only field that specifies the time when Advertiser was created.

string

N/A

N/A

updatedAt

Read-only field that specifies the time of the last update.

string

N/A

N/A

mdmId

Read-only field that specifies the MDM ID of the Advertiser.

integer

N/A

N/A

Contact Object

The contact object contains the following fields:

Name

Description

Type

Add

Update

firstName

Specifies the first name of the contact.

string

Optional

Optional

lastName

Specifies the last name of the contact.

string

Optional

Optional

addressLine1

Specifies the first line of contact information.

string

Required

Optional

addressLine2

Specifies the second line of contact information.

string

Optional

Optional

city

Specifies the contact’s city.

string

Required

Optional

region

Specifies the contact’s region or state.

string

Required

Optional

postalCode

Specifies the contact’s postal code.

string

Optional

Optional

country

Specifies the contact’s country.

string

Required

Optional

telephone

Specifies the contact’s telephone number.

string

Optional

Optional

email

Specifies the email address of the advertiser contact.

string

Optional

Optional

Sample Payload

{
  "contact": {
    "firstName": "Admin",
    "lastName": "Yahoo",
    "addressLine1": "Yahoo1",
    "addressLine2": "701st Avenue",
    "city": "Sunnyvale",
    "region": "CA",
    "country": "United States",
    "telephone": "4574888849",
    "email": "admin@yahooinc.com"
  }
}

Billing Contact Object

Billing contact fields are only included in the response for certain seats that need to comply with country-specific laws (i.e. the Sapin II Law in France). The billingContact object contains the following fields:

Name

Description

Type

Add

Update

firstName

Specifies the first name of the billing contact.

string

Required

Required

lastName

Specifies the last name of the billing contact.

string

Required

Required

email

Specifies the email address of the advertiser billing contact.

string

Required

Required

addressLine1

Specifies the first line of the billing contact information.

string

Required

Required

addressLine2

Specifies the second line of the billing contact information.

string

Optional

Optional

addressLine3

Specifies the third line of the billing contact information.

string

Optional

Optional

city

Specifies the billing contact’s city.

string

Required

Required

region

Specifies the billing contact’s region or state.

string

Optional

Optional

postalCode

Specifies the billing contact’s postal code.

string

Optional

Optional

country

Specifies the billing contact’s country.

string

Required

Required

vatNumber

Specifies the billing contact’s VAT Number.

string

Optional

Optional

legalMandateConfirmation

Confirms sending the legal mandate to the account manager.

boolean

Required

Required

Sample Payload

{
  "billingContact": {
    "firstName": "Admin",
    "lastName": "Yahoo",
    "email": "admin@yahooinc.com",
    "addressLine1": "Yahoo1",
    "addressLine2": "701st Avenue",
    "city": "Sunnyvale",
    "region": "CA",
    "postalCode": "94089",
    "country": "United States",
    "vatNumber": "123456789",
    "legalMandateConfirmation": true
  }
}

Measurement Rules Object

The Measurement rules object is only included when trying to retrieve all In-Flight Outcomes (IFO) measurement rules under an advertiser. Learn more at Read Advertiser Measurement Rules. The measurementRules object is read only and contains the following fields.

Name

Description

Type

Add

Update

type

Specifies the type of the measurement rule

String

N/A

N/A

ruleId

Specifies the Rule ID of the measurement rule

Integer

N/A

N/A

ruleName

Specifies the name of the measurement rule

String

N/A

N/A

vendorName

Specifies the name of the vendor of the measurement rule.

String

N/A

N/A

lookbackWindow

Specifies the lookback window for the measurement rule.

Integer

N/A

N/A

createdDate

Specifies the date when the measurement rule was created

String

N/A

N/A

Sample Response

{
  "type": "IFO",
  "ruleId": 123,
  "ruleName": "ISA Conversion Rule 1",
  "vendorName": "Vendor Name",
  "lookbackWindow": 30,
  "createdDate": "2025-01-15",
}

Measurement Rule Object

The Measurement rule object is only included when trying to retrieve the definition of an IFO measurement rule under an advertiser. Learn more at Read Advertiser Measurement Rule. The measurementRule object is read only and contains the following fields.

Name

Description

Type

Add

Update

type

Specifies the type of the measurement rule

String

N/A

N/A

ruleId

Specifies the Rule ID of the measurement rule

Integer

N/A

N/A

ruleName

Specifies the name of the measurement rule

String

N/A

N/A

vendorName

Specifies the name of the vendor of the measurement rule.

String

N/A

N/A

lookbackWindow

Specifies the lookback window for the measurement rule.

Integer

N/A

N/A

lookbackWindowUnit

Specifies the unit for the lookback window for the measurement rule.
Currently, the only valid value is “DAY”.

String

N/A

N/A

createdDate

Specifies the date when the measurement rule was created.

String

N/A

N/A

updatedDate

Specifies the date when the measurement rule was last updated.

String

N/A

N/A

accountId

Specifies the advertiser ID to which the measurement rule belongs to.

Integer

N/A

N/A

description

Specifies the description of the measurement rule

String

N/A

N/A

associatedEntities

Contains a list of line ids and campaign ids to which the measurement rule is actively associated.

lineIds: Contains list of line ids.
campaignIds: Contains list of campaign ids.

Object

N/A

N/A

upcCodes

Specifies a list of UPC codes that are assigned during rule creation.
Used in the case of IFO measurement rule.

Object

N/A

N/A

brands

Specifies the brands that are assigned to the rule at rule creation.
Used in the case of IFO measurement rule.
Learn more at Brands Object.

Object

N/A

N/A

country

Specifies the country which the measurement rule is meant to track.
Used in the case of Offline measurement rule.

String

N/A

N/A

Sample Response (IFO)

{
  "type": "IFO",
  "ruleId": 456,
  "ruleName": "ISA Conversion Rule 1",
  "vendorName": "Vendor Name",
  "lookbackWindow": 30,
  "lookbackWindowUnit": DAY, // This is static 
  "trackingCost": “Image: 1.0 | Video: 1.0 | CTV: 0.25”,
  "createdDate": "2025-01-15",
  "updatedDate": "2025-01-15",
  "accountId": 123,
  "description": “Test Rule”,
  "associatedEntityIds": {
    "lineIds": [12345, 67890, 11111],
    "campaignIds": [12345, 67890, 11111]
   }
  "upcCodes": [‘1123’, ‘123’],
  "brands": {
    "advertisers": [],
    "highBrands": [],
    "lowBrands": [
      {
        "advertiserName": "Adv Name ",
        "brandHighName": "Brand High Name ",
        "brandLowName": "Brand Low Name ",
        "category": "",
        "subCategory": ""
      }
    ]
  },
  "pixelId": 10203888,
  "pixelName": "Test"
}

Sample Response (Offline)

{
  "type": "Offline",
  "ruleId": 456,
  "ruleName": "Offline Conversion Rule 1",
  "vendorName": "Yahoo Store Visits",
  "lookbackWindow": 30,
  "lookbackWindowUnit": DAY, // This is static 
  "trackingCost": “Image: 1.0 | Video: 1.0 | CTV: 0.25”,
  "createdDate": "2025-01-15",
  "updatedDate": "2025-01-15",
  "accountId": 123,
  "description": “Test Rule”,
  "associatedEntityIds": {
    "lineIds": [12345, 67890, 11111],
    "campaignIds": [12345, 67890, 11111]
   },
  "country": "US"
}

Brands Object

The Brands object is only included when trying to retrieve the definition of an IFO  measurement rule. Learn more at Measurement Rule Object. The brands object contains the following fields.

Name

Description

Type

Add

Update

advertisers

Specifies the list of advertiser level brands.

Learn more at Brand Advertiser, High Brand, Low Brand Object.

Object

N/A

N/A

highBrands

Specifies the list of high brands.

Learn more at Brand Advertiser, High Brand, Low Brand Object.

Object

N/A

N/A

lowBrands

Specifies the list of low brands.

Learn more at Brand Advertiser, High Brand, Low Brand Object.

Object

N/A

N/A

Sample Response

"brands": {
    "advertisers": [],
    "highBrands": [],
    "lowBrands": [
      {
        "advertiserName": "Adv Name ",
        "brandHighName": "Brand High Name ",
        "brandLowName": "Brand Low Name ",
        "category": "",
        "subCategory": ""
      }
    ]
  }

Brand Advertiser, High Brand, Low Brand Object

The Advertiser/High Brand/Low Brand Object is only included when trying to retrieve the definition of an IFO measurement rule. Learn more at Measurement Rule Object.

Name

Description

Type

Add

Update

advertiserName

Specifies the name of the brand advertiser.

String

N/A

N/A

brandHighName

Specifies the name of the high brand.

String

N/A

N/A

brandLowName

Specifies the name of the low brand.

String

N/A

N/A

category

Specifies the category of the brand.

String

N/A

N/A

subCategory

Specifies the subcategory of the brand.

String

N/A

N/A

Sample Response

"lowBrands": [
      {
        "advertiserName": "Adv Name ",
        "brandHighName": "Brand High Name ",
        "brandLowName": "Brand Low Name ",
        "category": "",
        "subCategory": ""
      }
    ]

Read Advertiser

Get data for a specific advertiser.

Parameters

Parameter

Parameter Type

Description

Data Type

Required

id

path

Specifies the advertiser ID.

integer

Y

Sample Request URL

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

Sample Response

{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1,
    "name": "My Yahoo!!",
    "landingPageUrl": "https://www.yahoo.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": 501,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "mdmId": "41514", 
    "billingPrice": 20,
    "contact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "country": "United States",
      "telephone": "4574888849",
      "email": "admin@yahooinc.com"
    },
    "isCrossdeviceOff": false
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

For seats that need to comply with country-specific laws (such as France’s Sapin II law) the response contains an additional billing contact section.

Sample Response

{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1,
    "name": "My Yahoo!!",
    "landingPageUrl": "https://www.yahoo.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": 501,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "mdmId": "41524",
    "billingPrice": 20,
    "contact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "country": "United States",
      "telephone": "4574888849",
      "email": "admin@yahooinc.com"
    },
    "billingContact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "email": "admin@yahooinc.com",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "postalCode": "94089",
      "country": "United States",
      "vatNumber": "123456789",
      "legalMandateConfirmation": true
    },
    "isCrossdeviceOff": false
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

Read Advertisers

Get a filtered list of advertisers.

GET /traffic/advertisers?query={query}&page={page}&limit={limit}&sort={sort}&dir={dir}&startTime={startTime}&endTime={endTime}

Parameters

Parameter

Parameter Type

Description

Data Type

Required

query

query

Specifies the search term.

Use URL encoding conventions (i.e. a space should be replaced with a + or %20).

string

N

page

query

Specifies the page number.

integer

N

limit

query

Specifies the total number of items to return. Maximum allowed value is 100.

integer

N

sort

query

Specifies the column to sort by.

string

N

dir

query

Specifies the sort direction. Allowed values:

  • ASC: data is sorted in ascending order.

  • DESC: data is sorted in descending order.

string

N

startTime

query

Defines the start of the time window. Used with endTime to return Advertisers created or updated within a timeframe.

string

N

endTime

query

Defines the end of the time window. Used with startTime to return Advertisers created or updated within a timeframe.

string

N

Sample Request URL

GET https://dspapi.admanagerplus.yahoo.com/traffic/advertisers?page=1&limit=2&startTime=2026-03-01T00:00:00Z&endTime=2026-03-31T00:00:00Z

Sample Response

{
  "response": [
    {
      "status": "ACTIVE",
      "timezone": "America/New_York",
      "currency": "USD",
      "id": 1,
      "name": "My Yahoo!!",
      "landingPageUrl": "http://yahoo.com",
      "iabCategoryId": 1,
      "iabSecondaryCategoryId": 101,
      "accountGroupId": 2491,
      "updatedAt": "2026-03-05T19:10:10Z",
      "createdAt": "2026-03-05T19:10:10Z",
      "mdmId": "41454",
      "isCrossdeviceOff": false
    },
    {
      "status": "ACTIVE",
      "timezone": "America/Los_Angeles",
      "currency": "USD",
      "id": 2,
      "name": "Your Retail Sales Advertiser",
      "landingPageUrl": "http://www.yourretailsalesadvertiser.com",
      "iabCategoryId": 9,
      "iabSecondaryCategoryId": 927,
      "accountGroupId": 2491,
      "updatedAt": "2026-03-05T19:10:10Z",
      "createdAt": "2026-03-05T19:10:10Z",
      "mdmId": "41454",
      "isCrossdeviceOff": false
    }
  ],
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

Read Advertiser Measurement Rules

Get available Measurement Rules.

GET /traffic/advertisers/{accountId}/measurement-rules

Parameters

Parameter

Parameter Type

Description

Data Type

Required

accountId

path

Specifies the advertiser ID.

integer

Y

Sample Request URL

GET https://dspapi.admanagerplus.yahoo.com/traffic/advertisers/12345/measurement-rules

Response

{
  "response": {
    "measurementRules": [
      {
        "type": "IFO",
        "ruleId": 123,
        "ruleName": "ISA Conversion Rule 1",
        "vendorName": "Vendor Name",
        "lookbackWindow": 30,
        "createdDate": "2025-01-15"
      },
      {
        "type": "Offline",
        "ruleId": 456,
        "ruleName": "Offline Measurement Rule 1",
        "vendorName": "Offline Partner",
        "lookbackWindow": 14,
        "createdDate": "2025-01-10"
      },
      {
        "type": "IFO",
        "ruleId": 789,
        "ruleName": "Mail Purchase Rule 1",
        "vendorName": "Yahoo Mail",
        "lookbackWindow": 7,
        "createdDate": "2025-01-12"
      }
    ],
    "totalCount": 3,
    "warnings": [
      "Unable to fetch Offline rules" // This field shows partial fetch errors 
    ]
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

Read Advertiser Measurement Rule

Get available Measurement Rules.

GET /traffic/advertisers/{accountId}/measurement-rules/{ruleId}

Parameters

Parameter

Parameter Type

Description

Data Type

Required

accountId

path

Specifies the advertiser ID.

integer

Y

ruleId

path

Specifies the measurement rule ID.

Integer

Y

Sample Request URL

GET https://dspapi.admanagerplus.yahoo.com/traffic/advertisers/12345/measurement-rules/890

Sample Response (IFO)

{
  "response": {
    "type": "IFO",
    "ruleId": 456,
    "ruleName": "ISA Conversion Rule 1",
    "vendorName": "Vendor Name",
    "lookbackWindow": 30,
    "lookbackWindowUnit": "DAY",
    "trackingCost": "Image: 1.0 | Video: 1.0 | CTV: 0.25",
    "createdDate": "2025-01-15",
    "updatedDate": "2025-01-15",
    "accountId": 123,
    "description": "Test Rule",
    "associatedEntityIds": {
      "lineIds": [
        12345,
        67890,
        11111
      ],
      "campaignIds": [
        12345,
        67890,
        11111
      ]
    },
    "upcCodes": [
      "1123",
      "123"
    ],
    "brands": {
      "advertisers": [],
      "highBrands": [],
      "lowBrands": [
        {
          "advertiserName": "Adv Name ",
          "brandHighName": "Brand High Name ",
          "brandLowName": "Brand Low Name ",
          "category": "",
          "subCategory": ""
        }
      ]
    },
    "pixelId": 10203888,
    "pixelName": "Test"
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

Response (Offline)

{
  "response": {
    "type": "Offline",
    "ruleId": 456,
    "ruleName": "Offline Conversion Rule 1",
    "vendorName": "Yahoo Store Visits",
    "lookbackWindow": 30,
    "lookbackWindowUnit": "DAY",
    "trackingCost": "Image: 1.0 | Video: 1.0 | CTV: 0.25",
    "createdDate": "2025-01-15",
    "updatedDate": "2025-01-15",
    "accountId": 123,
    "description": "Test Rule",
    "associatedEntityIds": {
      "lineIds": [
        12345,
        67890,
        11111
      ],
      "campaignIds": [
        12345,
        67890,
        11111
      ]
    },
    "country": "US"
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

Export Product Catalog

An email containing an excel sheet with product catalog details of a measurement rule is sent to the current user.

GET traffic/v3/offlinepurchase/advertiser/{advertiserId}/rules/{ruleId}/export

Parameters

Parameter

Parameter Type

Description

Data Type

Required

advertisertId

path

Specifies the advertiser ID.

integer

Y

ruleId

path

Specifies the measurement rule ID

Integer

Y

Sample Request URL

GET https://dspapi.admanagerplus.yahoo.com/traffic/v3/offlinepurchase/advertiser/123/rules/456/export

Response

{
  "response": {
    "message": "Report created, will be emailed shortly"
   },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

Create Advertiser

Create a new advertiser.

POST /traffic/advertisers

Parameters

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

Sample Request URL

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

Sample Request Body

{
  "name": "TEST_1_3",
  "landingPageUrl": "http://www.example.com",
  "iabCategoryId": 5,
  "timezone": "Etc/GMT",
  "currency": "USD",
  "status": "ACTIVE",
  "billingPrice": 40.5,
  "contact": {
    "addressLine1": "1 N.First St",
    "addressLine2": "",
    "city": "Sunnyvale",
    "region": "CA",
    "postalCode": "94056",
    "country": "United States"
  }
}

Sample Response

{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1259301,
    "name": "TEST_1_3",
    "landingPageUrl": "http://www.example.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": -1,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "billingPrice": 40.5,
    "contact": {
      "addressLine1": "1 N.First St",
      "addressLine2": "",
      "city": "Sunnyvale",
      "region": "CA",
      "postalCode": "94056",
      "country": "United States"
    },
    "isCrossdeviceOff": false
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

For seats that need to comply with country-specific laws (such as France’s Sapin II law) the payload should contain the billing contact fields.

Sample Request Body

{
  "name": "TEST_1_3",
  "landingPageUrl": "http://www.example.com",
  "iabCategoryId": 5,
  "timezone": "Etc/GMT",
  "currency": "USD",
  "status": "ACTIVE",
  "billingPrice": 40.5,
  "contact": {
    "addressLine1": "1 N.First St",
    "addressLine2": "",
    "city": "Sunnyvale",
    "region": "CA",
    "postalCode": "94056",
    "country": "United States"
  },
  "billingContact": {
    "firstName": "Admin",
    "lastName": "Yahoo",
    "email": "admin@yahooinc.com",
    "addressLine1": "Yahoo1",
    "addressLine2": "701st Avenue",
    "city": "Sunnyvale",
    "region": "CA",
    "postalCode": "94089",
    "country": "United States",
    "vatNumber": "123456789",
    "legalMandateConfirmation": true
   }
}

Sample Response

{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1259301,
    "name": "TEST_1_3",
    "landingPageUrl": "http://www.example.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": -1,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "billingPrice": 40.5,
    "contact": {
      "addressLine1": "1 N.First St",
      "addressLine2": "",
      "city": "Sunnyvale",
      "region": "CA",
      "postalCode": "94056",
      "country": "United States"
    },
    "billingContact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "email": "admin@yahooinc.com",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "postalCode": "94089",
      "country": "United States",
      "vatNumber": "123456789",
      "legalMandateConfirmation": true
    },
    "isCrossdeviceOff": false
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

Update Advertiser

Update an existing advertiser.

PUT /traffic/advertisers/{id}

Partial updates are supported; values of supported fields that are not in the payload remain unchanged. For seats that need to comply with country-specific laws (such as France’s Sapin II law) the payload can contain the billing contact fields.

Parameters

The Advertiser 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/advertisers/1

Sample Request Body

{
  "status": "ACTIVE",
  "isCrossdeviceOff": true,
  "billingPrice": 23,
  "currency": "USD"
}

Sample Response

{
  "response": {
    "status": "ACTIVE",
    "timezone": "Etc/GMT",
    "currency": "USD",
    "id": 1,
    "name": "My Yahoo!!",
    "landingPageUrl": "https://www.yahoo.com",
    "iabCategoryId": 5,
    "iabSecondaryCategoryId": 501,
    "updatedAt": "2026-03-05T19:10:10Z",
    "createdAt": "2026-03-05T19:10:10Z",
    "mdmId": "41454",
    "billingPrice": 23,
    "contact": {
      "firstName": "Admin",
      "lastName": "Yahoo",
      "addressLine1": "Yahoo1",
      "addressLine2": "701st Avenue",
      "city": "Sunnyvale",
      "region": "CA",
      "country": "United States",
      "telephone": "4574888849",
      "email": "admin@yahooinc.com",
      "postalCode": "94056"
    },
    "isCrossdeviceOff": true
  },
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

Delete Advertiser

The DSP Traffic API does not support deletion of advertisers.

Read Advertiser Beacon Lookups

Get available beacons.

GET /traffic/advertisers/{accountId}/beaconlookups

Parameters

Parameter

Parameter Type

Description

Data Type

Required

accountId

path

Specifies the advertiser ID.

integer

Y

Sample Request URL

GET https://dspapi.admanagerplus.yahoo.com/traffic/advertisers/1356341/beaconlookups

Sample Response

{
  "response": [
    {
      "id": 6508313,
      "name": "test conversion1",
      "dotPixel": true
    },
    {
      "id": 6508309,
      "name": "CPA Pixel",
      "dotPixel": true
    }
  ],
  "errors": null,
  "timeStamp": "2026-03-06T05:22:42Z"
}

Support
Brands
  • © 2026 Yahoo. All rights reserved.