Endpoints
Method | Endpoint | Description |
GET | /v3/advertisers | List all advertisers |
POST | /v3/advertisers | Create new advertiser |
GET | /v3/advertisers/[id] | Get details for a specific advertiser |
PUT | /v3/advertisers/[id] | Update a specific advertiser |
List Advertisers
Method: GET
Endpoint: /advertisers
Example
Response
{ "data": [ { "id": 100, "name": "Advertiser X" }, { "id": 101, "name": "Advertiser Y" } ] }Get Advertiser
Method: GET
Endpoint: /v3/advertisers/[id]
Example
Response
{ "data": { "id": 1001, "logo_url": "//ntvassets-a.akamaihd.net/5B05AD8C7BF347818F0E3B676B61D41E.jpg", "name": "Advertiser X", "url": "http://www.advertiserdomain.com", "vertical_id": 13 } }Create Advertiser
Method: POST
Endpoint: /v3/advertisers/
Parameters
Parameter | Type | Description |
| string | Name of the advertiser. |
| string | Url of the advertiser. For example, http://www.nativo.com. |
| integer | ID of the advertiser veritical. Vertical IDs can be found here |
| string | URL to an image to use as the advertiser's logo. The advertiser logo is displayed on ad units and article landing pages. On POST, the image will be downloaded and thereafter served from a Nativo domain. |
Example
Payload
{ "name": "Advertiser X", "url": "http://www.advertiserdomain.com", "vertical_id": 13, "logo_url": "http://ntvassets-a.akamaihd.net/5B05AD8C7BF347818F0E3B676B61D41E.jpg" }Response
{ "data": { "id": 1001, "logo_url": null, "name": "Advertiser X", "url": "http://www.advertiserdomain.com", "vertical_id": 13 } }
Update Advertiser
Method: PUT
Endpoint: /v3/advertisers/[id]
Example
Update the advertiser name.
Update the advertiser name.
Payload
{ "name": "Advertiser Z" }Response
{ "data": { "id": 1001, "logo_url": null, "name": "Advertiser Z", "url": "http://www.advertiserdomain.com", "vertical_id": 13 } }