List of Advertisers

GET {{campaign_url}}/advertisers?marketId=1&offset=0&limit=2&sortOrder=asc&sortKey=name

Retrieve a list of advertisers

You can retrieve all of the advertisers within your market by sending this GET request.

Note: If you have access to multiple markets, you must specify a value for marketId. Otherwise (i.e., marketId is left unchecked), the request will return a 300 Multiple Choices response containing a list of market IDs that can be passed as marketId values.

Request Params

KeyDatatypeRequiredDescription
marketIdnumberNumeric ID associated with a given market. Required only if you have access to multiple markets.
offsetnumberThe starting index in the list of advertiser objects.
limitnumberThe number of advertiser objects to return.
sortOrderstringDirection by which results should be sorted.

Allowed values: asc, desc | | sortKey | string | | Field by which results should be sorted.

Allowed values: id, name |

RESPONSES

status: OK

{"queryTotal":175,"data":[{"id":"1602845563","marketId":"1","resourceType":"advertiser","status":"play","accountId":"0908070","createdAt":"2016-06-23T19:11:48Z","updatedAt":"2021-04-29T10:49:32Z","name":"-","primaryUrl":"http://www.amobee.com","currency":"usd","viewabilityProviders":{"display":"doubleVerify","video":"moat","mobile":"doubleVerify"},"nielsenCampaignOptIn":false,"identityPlatformVendor":"Probabilistic"},{"id":"1602698669","marketId":"1","resourceType":"advertiser","status":"play","accountId":"1918171","createdAt":"2016-04-27T19:58:37Z","updatedAt":"2021-02-04T00:16:08Z","name":"-","primaryUrl":"http://amobee.com","currency":"usd","viewabilityProviders":{"display":"doubleVerify","video":"moat","mobile":"doubleVerify"},"nielsenCampaignOptIn":false,"identityPlatformVendor":"Probabilistic"}],"errors":[],"links":{"self":"https://services.amobee.com/campaign/v5/api/advertisers?marketId=1\u0026offset=0\u0026limit=2\u0026sortOrder=asc\u0026sortKey=name","next":"https://services.amobee.com/campaign/v5/api/advertisers?marketId=1\u0026offset=2\u0026limit=2\u0026sortOrder=asc\u0026sortKey=name"}}