HomeProduct DocumentationUser Guides
v1.0
Jivox API Documentation

Get Advertisers API

Given a publisher ID and an optional date, this API retrieves all the advertisers added to the system for the publisher since the specified date. If no date is specified, this request returns all the advertisers for the publisher ID. Data returned is in XML and includes the following information:

  • Advertiser ID
  • Advertiser Name
  • Advertiser Email Address
  • Company Name
  • Publisher ID
  • Publisher Name
  • Group ID
  • Group Name
  • Site ID
  • Site Name
  • Creation Date

This API includes information for all advertisers. To return only active advertisers, refer to Get Active Advertisers API.

Request URL

To retrieve advertisers, make a request to the following URL:

http:///jivox/serverAPIs/externalReporting/getAdvertisers.php

Parameters

The request URL supports the following parameters:

apiId(Required) ID of the API.
apiKey(Required) Authentication key.
apiVersion(Required) Version number of the API for which authentication key is generated.
publisherId(Required) ID of the publisher or agency for which authentication key is generated.
sinceDate(Optional) Return advertisers added to the system since this date.
groupId(Optional) Filter by group ID.
siteId(Optional) Filter by site ID.

Example

Using cURL (this command includes hard returns for readability):

Javascript
Copy

Server Success Response

In case of success, the server returns a response with the structure shown below:

Javascript
Copy
Next to read:
Get Active Advertisers API
On This Page
Get Advertisers APIRequest URLParametersExampleServer Success Response