1. Advertiser Methods
2. advertisers

advertisers

This method returns suggestions for advertiserIDs. Results can be filtered by using query parameters. This method is handy for implementing auto-completion form elements in your web application’s UI.

URL Format

http://api.adbeat.com/v3/{api-key}/advertisers

Parameters

Parameter Name	Meaning	Default Value	Notes
q	query	(required)	No wildcards needed or used – e.g. uk will find publishers-uk.com as a suggestion.
countryId	country filter	(no filtering)	e.g. us (See countries)
platformId	platform filter	(no filtering)	e.g. desktop (See platforms) To specify multiple values, separate them by commas (e.g. iPhone,iPad) Currently only desktop is supported for a non-us countryId. Use &platformId=mobile to specify all mobile devices (i.e. android, iphone, ipad, androidtablet)
rows	Number of results to return	10	Maximum 100
start	Index of first result to return	0	Use start=N (where N > 0) to page through results by making repeated requests.
fields	fields filter	(no filtering)	Restrict which fields get returned. e.g. &fields=suggestion would return just one of the available fields. &fields=suggestion,score would return just two of the available fields.

Return Fields

Field Name	Example	Notes
countryId	us	See countries
platformId	desktop	See platforms
suggestion	publishers-uk.com	Suggested advertiserId for the provided query.
score	4930	Score of result, based on the magnitude of the advertiser’s activity and other factors.
apiUnits	35	The number of API units consumed by this request.

Usage Example(s)

To find suggestions that contain ace do this:

http://api.adbeat.com/v3/{api-key}/advertisers/?q=ace

JSON Response

{
    "statusCode": 200,
    "numHits": 2546,
    "hits": [{
        "countryId": "us",
        "score": 597,
        "suggestion": "ace-pt.org",
        "platformId": "desktop"
    }, {
        "countryId": "us",
        "score": 525,
        "suggestion": "acehardware.com",
        "platformId": "desktop"
    }, {
        "countryId": "us",
        "score": 385,
        "suggestion": "aceexhibits.com",
        "platformId": "desktop"
    }, {
        "countryId": "us",
        "score": 366,
        "suggestion": "acebrand.com",
        "platformId": "desktop"
    }, {
        "countryId": "us",
        "score": 354,
        "suggestion": "acefitness.org",
        "platformId": "desktop"
    }, {
        "countryId": "us",
        "score": 306,
        "suggestion": "ace-pt.org",
        "platformId": "iphone"
    }, {
        "countryId": "us",
        "score": 258,
        "suggestion": "acer.com",
        "platformId": "desktop"
    }, {
        "countryId": "us",
        "score": 257,
        "suggestion": "acecanopy.com",
        "platformId": "desktop"
    }, {
        "countryId": "us",
        "score": 251,
        "suggestion": "ace-pt.org",
        "platformId": "android"
    }, {
        "countryId": "us",
        "score": 206,
        "suggestion": "ace2three.com",
        "platformId": "desktop"
    }],
    "apiUnits": 35,
    "statusMsg": "successful advertisers request",
    "requestParameters": {
        "q": "ace"
    },
    "handler": "advertisers"
}

You can also use parameters to get more specific and detailed results. To find suggestions that contain credit, limit the results to the us, and return 5 rows of data instead of the default 10 rows, do this:

http://api.adbeat.com/v3/{api-key}/advertisers/?q=credit&countryid=us&rows=5

JSON Response

{
    "statusCode": 200,
    "numHits": 1018,
    "hits": [{
        "score": 1294,
        "suggestion": "creditcards.com",
        "platformId": "desktop"
    }, {
        "score": 598,
        "suggestion": "credit-land.com",
        "platformId": "desktop"
    }, {
        "score": 491,
        "suggestion": "creditscore.com",
        "platformId": "desktop"
    }, {
        "score": 479,
        "suggestion": "creditcardguide.com",
        "platformId": "desktop"
    }, {
        "score": 467,
        "suggestion": "creditkarma.com",
        "platformId": "desktop"
    }],
    "apiUnits": 30,
    "statusMsg": "successful advertisers request",
    "requestParameters": {
        "q": "credit",
        "countryid": "us",
        "rows": "5"
    },
    "handler": "advertisers"
}