Creating a publisher’s ad space

Parameters

HTTP method

Access rights

URL

Parameters

Note

POST manage_websites https://api.admitad.com/website/create/ Request parameters list.
  • * Returns the result in the JSON format.

Request parameters list.

Name

Type

Required

Settings restrictions

Note, allowed values

name string max length - 200  
kind string max length - 20 Types of ad spaces (‘social_app’, ‘social_group’, ‘website’, ‘doorway’)
language string max length - 2 System languages
adservice integer  

List of advertising services (mandatory for kind = ‘social_app’, ‘social_group’)

site_url string max length - 255  
description string
max length - 20000
min length - 100
 
categories array of integers   Categories of affiliate programs
regions array of strings   Ad space regions
mailing_targeting bool  

1 or 0

possibility of targeting newsletters (only for E-Mail newsletters)

Example of data for a request

regions=RU&regions=UA&kind=website&atnd_visits=3&adservice=5&name=Some+website+name&language=ru&description=some+description&atnd_hits=5&categories=1&categories=2&categories=3&site_url=http%3A%2F%2Fgoogle.by

Example of use

Example of a request with utility ``curl``:

curl -L -H 'Authorization: Bearer access_token' -X POST https://api.admitad.com/website/create/ -d 'regions=RU&regions=UA&kind=website&atnd_visits=3&adservice=5&name=Some+website+name&language=ru&description=some+description&atnd_hits=5&categories=1&categories=2&categories=3&site_url=http%3A%2F%2Fgoogle.by'

Example of a raw request:

POST /website/create/ HTTP/1.1
User-Agent: curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3
Host: api.admitad.com
Accept: */*
Authorization: Bearer access_token

regions=RU&regions=UA&kind=website&adservice=5&name=Some+website+name&language=ru&description=some+description&categories=1&categories=2&categories=3&site_url=http%3A%2F%2Fgoogle.by

Example of the response from the API server in the JSON format:

{
    "status": "new",
    "kind": "website",
    "is_old": false,
    "name": "Some website name",
    "language": "en",
    "deleted": false,
    "creation_date": "2012-05-22 19:37:10",
    "verification_code": "4082e93ca7",
    "site_url": "http://google.by/",
    "regions": [
        {
            "region": "RU",
            "id": 16
        },
        {
            "region": "UA",
            "id": 17
        }
    ],
    "vip": false,
    "id": 44,
    "categories": [
        {
            "name": "Shop",
            "id": 1
        },
        {
            "name": "Online Games",
            "id": 2
        },
        {
            "name": "Browser",
            "id": 3
        }
    ],
    "description": "some description"
}

Description of API server response fields

Name

Description

id

Ad space ID

name

Name of ad space

description

Ad space description

status

Ad space status

creation_date

Ad space creation date

site_url

Ad space website

verification_code

Verification code

kind Types of ad spaces
language System languages
regions Ad space regions
adservice List of advertising services
categories Categories of affiliate programs