YieldKit provides a basic HTTP API for advertiser coverage requests. Requests are made via an HTTP GET request in the form of:
Advertiser Method
http://api.yieldkit.com/v1/advertiser?
api_key=&
api_secret=&
site_id=&
q=&
page_size=&
page=&
format=
Parameters:
Parameter | Required | Description |
---|---|---|
api_key | yes | Find your API Key under home.yieldkit.com under the API tab |
api_secret | yes | Find your API Secret under home.yieldkit.com under the API tab |
site_id | yes | The site_id for which you want to receive the approved advertiser |
country | no | ISO2 Code, e.g. US, UK or DE |
category_id | no | Limits the advertiser pograms to be within a certain category. Please use the numeric codes as listed in the table below. |
q | no | Keyword filter / Search query for advertiser name, domain and advertiser id, f.e. „1and1 Internet“, replace spaces („ “) with „+“ („1and1 Internet“ -> „1and1+internet“) |
page_size | yes | Number of results per page (Default: 10, Maximum: 100) |
page | yes | Number of page, starting at 1 |
format | yes | csv or json |
Advertiser Categories
Numeric Code | Advertiser Category |
20 |
Arts & Entertainment |
21 |
Automotive |
22 |
Business |
23 |
Careers |
24 |
Education |
25 |
Family & Parenting |
26 |
Health & Fitness |
27 |
Food & Drink |
28 |
Hobbies & Interests |
29 |
Home & Garden |
30 |
Law, Gov't & Politics |
31 |
News |
32 |
Personal Finance |
33 |
Society |
34 |
Pets |
35 |
Sports |
36 |
Style & Fashion |
37 |
Technology & Computing |
38 |
Real Estate |
39 |
Travel |
40 |
Shopping |
41 |
Religion and Spirituality |
42 |
Uncategorized |
43 |
Science |
44 |
Adult |
http://api.yieldkit.com/v1/advertiser?
api_key=635666fa72ddf39eadbf04183e2bf80d&
api_secret=74607007cdb6b0db4b3219c8adee3e09&
site_id=4d4984efe3f5a25a4b98ac6a&
country=US&
q=1and1+internet&
page_size=10&
page=1&
format=json
Sample response JSON:
{
"total":100,
"page":1,
"size":10,
"advertisers":[
{
"id":"4ea168073004d432cf731d64",
"name":"Ölscheich24 - Qualitätsöle für PKWs und Motorräder ",
"description":"Ölscheich 24 ist der professionelle Anbieter für [...]",
"countries":["DE"],
"url":"http://www.motoroel.com",
"domain":"motoroel.com",
"image":"http://ui.belboon.com/images/logos/logo_12417.gif",
"trackinglink":"https://r.secprf.com/v1/redirect?type=linkId[...]"
"payPerSale":5.00,
"payPerLead":10.00,
},
...
]
}