Оглавление

Change log

Date	API version	Change
4 September 2015	v1.33	Added authentication reference
24 September 2015	v1.35	Add "last-modified" support
10 October 2015	v1.36	Added object "forecast" for advertiser
5 November 2015	v1.37	Campaigns, campaign_groups, creatives, sites added to common objects

Introduction

This document describes the API of GetIntent DSP. The API consists of two major parts:

...

The main objective of this API is campaign management API.

General approach: object and methods

API is build as JSON RESTful service. Each object has it’s JSON representation and could be retrieved using get method. Also list, update and new are available.
Each type of JSON object has name and id. The structure is as follows:\

...

Where token is authentication token (it could be obtained through user settings in UI)

Advertiser Object

Below you will find API examples advertiser's objects to work with.

Important: All variables are required!

Variables

Variable	Description
<advertiser_id>	Advertiser's ID. Important: Advertiser's settings have to be managed at Common and System level
<entity>	Object type (Campaigns, sites etc..)
<entity_id>	Object's ID
<token>	Token to access to API. It can be found at user's settings. Important: user has to have access to advertiser with id = <advertiser_id>

Available Entities

Character ID	Description
campaigns	Ad Campaigns
campaign_groups	Ad Campaigns Groups
creatives	Creatives
sites	Sites
domains_lists	Domain lists
snippets	Snippets
segment_definitions	Segments
forecast	Campaigns status and forecast (only list method is available)

Methods

Entity's objects list

Блок кода

language	bash

GET https://ui.getintent.com/api/v1/advertisers/<advertiser_id>/<entity>/list?token=<token>

...

Блок кода

language	bash

GET https://ui.getintent.com/api/v1/advertisers/<advertiser_id>/<entity>/all?token=<token>

Additional parameters

Parameter	Description	Available at, method	Values	By default	Example
mode	Affects on list's view. Old version: all collection will be returned at root (deprecated) New version: all collection will be placed to data node Value recommend to use always: 1	all, list	0 - old version (deprecated). 1 - new version.	0	../list?token=<token>&mode=1
custom_fields	Includes all listed object's fields in output for "list" method	list	Listed by comma additional fields.	null	../list?token=<token>&custom_fields=starts,ends
page_limit	Limits count of items per request. Realizes pagination. If "page_limit" parameter is used, then "mode" property's value becomes mode=1 automatically.	all, list	Count of items per one page.	null	../list?token=<token>&page_limit=10
page	Current page. Works with "page_limit" method together only.	all, list	Current page in output.	null	../list?token=<token>&page_limit=10&page=2
pretty	Controls JSON output format	all,list	0 - minimized JSON , 1 - formatted JSON	0	../list?token=<token>&page_limit=10&pretty=1

Additional headers

Parameter	Description	Available at, method	Values	By default	Example
if-modified-since	Return header HTTP 304 Not Modified without content, if data has not updated since this date	list	Date in specify format D, d M Y H:i:s GMT	null	if-modified-since: Fri, 18 Sep 2015 10:34:37 GMT

Блок кода

language	js
title	Example of API JSON output in case page, page_limit params are envolved

{
    "data": {
        "921": {
            "id": "921",
            "name": "test_campaign"
        },
        "1400": {
            "id": "1400",
            "name": "1"
        }
    },

    "pages": {
        "total_elements": "6",
        "total_pages": 3,
        "current_page": 1,
        "previous_page": false,
        "next_page": 2,
        "page_size": 2,
        "offset": 0
    }
}

Create an Entity

Блок кода

language	bash

PUT https://ui.getintent.com/api/v1/advertisers/<advertiser_id>/<entity>/new?token=<token>

...

Блок кода

language	bash

curl --data '{"name": "title"}' -X PUT https://ui.getintent.com/api/v1/advertisers/<advertiser_id>/<entity>/new?token=<token>

Get an Entity

Блок кода

language	bash

GET https://ui.getintent.com/api/v1/advertisers/<advertiser_id>/<entity>/get/<entity_id>?token=<token>

...

Блок кода

language	bash

curl -X GET https://ui.getintent.com/api/v1/advertisers/<advertiser_id>/<entity>/get/<entity_id>?token=<token>

Additional headers

Parameter	Description	Available at, method	Values	By default	Example
if-modified-since	Return header HTTP 304 Not Modified without content, if data has not updated since this date	get	Date in specify format D, d M Y H:i:s GMT	null	if-modified-since: Fri, 18 Sep 2015 10:34:37 GMT

Update an Entity

Блок кода

language	bash

PUT https://ui.getintent.com/api/v1/advertisers/<advertiser_id>/<entity>/edit/<entity_id>?token=<token>

...

Блок кода

language	bash

curl --data '{"name": "new title"}' -X PUT https://ui.getintent.com/api/v1/advertisers/<advertiser_id>/<entity>/edit/<entity_id>?token=<token>

Delete an Entity

Блок кода

language	bash

DELETE https://ui.gcom/api/v1/advertisers/<advertiser_id>/<entity>/delete/<entity_id>?token=<token>

...

Блок кода

language	bash

curl -X DELETE https://ui.g getintent com/api/v1/advertisers/<advertiser_id>/<entity>/delete/<entity_id>?token=<token>

Common and System Objects

Here you'll find API examples for work with Common and System objects.

...

Important! All variables are required.

Variables

Variable	Description
<entity>	Object type (reference_tables, segment_definitions и тд)
<entity_id>	Object's ID
<token>	Token for API access. Its value can be found at "my settings" user's menu. Important: token has to belong to Admin user.

Available Entities

ID	Description
advertisers	Advertiser and its settings. Important: Advertiser's objects have to be managed at Advertiser's level
segment_definitions	Common segments
reference_tables	Contains additional information and variety settings
domains_lists	Common domain lists
snippets	Common snippets

Methods

Entity's objects list

Блок кода

language	bash

GET https://ui.getintent.com/api/v1/<entity>/list?token=<token>

...

Блок кода

language	bash

GET https://ui.getintent.com/api/v1/<entity>/all?token=<token>

Additional parameters

Parameter	Description	Available at, method	Values	By default	Example
mode	Affects on list's view. Old version: all collection will be returned at root (deprecated) New version: all collection will be placed to data node Value recommend to use always: 1	all, list	0 - old version (deprecated). 1 - new version.	0	../list?token=<token>&mode=1
custom_fields	Includes all listed object's fields in output for "list" method	list	Listed by comma additional fields.	null	../list?token=<token>&custom_fields=starts,ends
page_limit	Limits count of items per request. Realizes pagination. If "page_limit" parameter is used, then "mode" property's value becomes mode=1 automatically.	all, list	Count of items per one page.	null	../list?token=<token>&page_limit=10
page	Current page. Works with "page_limit" method together only.	all, list	Current page in output.	null	../list?token=<token>&page_limit=10&page=2

Additional headers

Parameter	Description	Available at, method	Values	By default	Example
if-modified-since	Return header HTTP 304 Not Modified without content, if data has not updated since this date	list	Date in specify format D, d M Y H:i:s GMT	null	if-modified-since: Fri, 18 Sep 2015 10:34:37 GMT

Create an Entity

Блок кода

language	bash

PUT https://ui.getintent.com/api/v1/<entity>/new?token=<token>

...

Блок кода

language	bash

curl --data '{"name": "title"}' -X PUT https://ui.getintent.com/api/v1/<entity>/new?token=<token>

Get an Entity

Блок кода

language	bash

GET https://ui.getintent.com/api/v1/<entity>/get/<entity_id>?token=<token>

...

Блок кода

language	bash

curl -X GET https://ui.getintent.com/api/v1/<entity>/get/<entity_id>?token=<token>

Additional headers

Parameter	Description	Available at, method	Values	By default	Example
if-modified-since	Return header HTTP 304 Not Modified without content, if data has not updated since this date	get	Date in specify format D, d M Y H:i:s GMT	null	if-modified-since: Fri, 18 Sep 2015 10:34:37 GMT

Update an Entity

Блок кода

language	bash

PUT https://ui.getintent.com/api/v1/<entity>/edit/<entity_id>?token=<token>

...

Блок кода

language	bash

curl --data '{"name": "new title"}' -X PUT https://ui.getintent.com/api/v1/<entity>/edit/<entity_id>?token=<token>

Delete an Entity

Блок кода

language	bash

DELETE https://ui.getintent.com/api/v1/<entity>/delete/<entity_id>?token=<token>

...

Дерево страниц

Сравнение версий

Старая версия 4

Новая версия 5

Ключ

Introduction

General approach: object and methods

Advertiser Object

Variables

Available Entities

Methods

Entity's objects list

Additional parameters

Additional headers

Create an Entity

Get an Entity

Additional headers

Update an Entity

Delete an Entity

Common and System Objects

Variables

Available Entities

Methods

Entity's objects list

Additional parameters

Additional headers

Create an Entity

Get an Entity

Additional headers

Update an Entity

Delete an Entity

Дерево страниц

История страницы

Сравнение версий

Старая версия 4

Новая версия 5

Ключ

Introduction

General approach: object and methods

Advertiser Object

Variables

Available Entities

Methods

Entity's objects list

Additional parameters

Additional headers

Create an Entity

Get an Entity

Additional headers

Update an Entity

Delete an Entity

Common and System Objects

Variables

Available Entities

Methods

Entity's objects list

Additional parameters

Additional headers

Create an Entity

Get an Entity

Additional headers

Update an Entity

Delete an Entity