Advertiser data

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":"http://r.srvtrck.com/v1/redirect?type=linkId[...]"
                "payPerSale":5.00,
                "payPerLead":10.00,
        },
        ...
        ]
}