Sign in | Sign up

advertiserInfo

This method returns data about a specific advertiser. To use this method, you need to pass a specific advertiserId (domain name).

Request Cost: 250 units, Result Cost: none

URL Format

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

Parameters

Parameter Name Meaning Default Value Notes
countryId country filter us
e.g. us (See countries)
platformId platform filter (no filtering) e.g. desktop (See platforms) Currently only desktop is supported for a non-us countryId. Use &platformId=mobile to specify all mobile devices (i.e. android, iphone, ipad, androidtablet)
adMetricId Format for ad metric data adImpact Other option: adSpend
maxAdvertisers maximum size of similarAdvertisers array 10
maxPublishers maximum size of recommendedPublishers array 10 Maximum: 100
maxChannels maximum size of recommendedChannels array 10 Maximum: 100

Return Fields

Field Name Example Notes
countryId us See countries
platformId desktop See platforms
phrases
[
    {
        "phrase": "information"
    },
    {
        "phrase": "yahoo"
    },
    {
        "phrase": "portal"
    }
]
An array of information about key phrases.
iabCategories
[{
    "iab": "News & Entertainment",
    "adImpact": 49585
}]
An array of information about IAB categories, in order from most to least definitive, including the ad impact of each. If &adMetricId=adSpend, then the adImpact field will be replaced with adSpend.
similarAdvertisers
[{
    "advertiserId": "cnn.com",
    {
        "phrases": [{
            "phrase": "setter"
        }, {
            "phrase": "sync"
        }]
    }
}]
An array of information about similar advertisers, in order from most similar to least similar, including the matching phrases.
recommendedPublishers
[{
    "publisherId": "huffingtonpost.com",
    "publisherSize": "1149003",
    "advertisers": [{
        "advertiserId": "citicards.com"
    }, {
        "advertiserId": "amextravel.com"
    }]
}]
An array of information about recommended publishers, in order from best to worst, including the similar advertisers on which each recommendation was based.
recommendedChannels
[{
    "publisherId": "sports.yahoo.com",
    "publisherSize": "1165073",
    "advertisers": [{
        "advertiserId": "citicards.com"
    }, {
        "advertiserId": "amextravel.com"
    }]
}]
An array of information about recommended channels, in order from best to worst, including the similar advertisers on which each recommendation was based.
apiUnits 250 The number of API units consumed by this request.

Usage Example(s)

To get information about the advertiser cnn.com do this:

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

JSON Response

{
    "countryId": "us",
    "statusMsg": "successful advertiserInfo/cnn.com request",
    "apiUnits": 250,
    "platformId": "desktop",
    "similarAdvertisers": [{
        "phrases": [{
            "phrase": "cnn money"
        }, {
            "phrase": "young millionaire"
        }, {
            "phrase": "millionaire"
        }],
        "advertiserId": "wealthfront.com"
    }, {
        "phrases": [{
            "phrase": "millionaire"
        }],
        "advertiserId": "fool.com"
    }, {
        "phrases": [{
            "phrase": "swimsuit"
        }, {
            "phrase": "kate"
        }],
        "advertiserId": "instyle.com"
    }, {
        "phrases": [{
            "phrase": "kate"
        }],
        "advertiserId": "cafemom.com"
    }, {
        "phrases": [{
            "phrase": "illustrate"
        }, {
            "phrase": "swimsuit"
        }],
        "advertiserId": "si.com"
    }, {
        "phrases": [{
            "phrase": "oscar"
        }],
        "advertiserId": "bankrate.com"
    }, {
        "phrases": [{
            "phrase": "reimagine"
        }, {
            "phrase": "tune"
        }],
        "advertiserId": "beatsbydre.com"
    }, {
        "phrases": [{
            "phrase": "tbs"
        }, {
            "phrase": "tonight"
        }],
        "advertiserId": "tbs.com"
    }, {
        "phrases": [{
            "phrase": "millionaire"
        }],
        "advertiserId": "highincomerealestate.com"
    }, {
        "phrases": [{
            "phrase": "redford"
        }, {
            "phrase": "robert"
        }],
        "advertiserId": "food.com"
    }],
    "iabCategories": [{
        "adImpact": 393849,
        "iab": "News"
    }, {
        "adImpact": 207004,
        "iab": "Arts & Entertainment>Humor"
    }, {
        "adImpact": 157964,
        "iab": "Sports>Golf"
    }, {
        "adImpact": 134059,
        "iab": "Arts & Entertainment"
    }, {
        "adImpact": 64162,
        "iab": "Law, Gov't & Politics"
    }, {
        "adImpact": 56183,
        "iab": "Sports>Pro Basketball"
    }, {
        "adImpact": 46124,
        "iab": "Sports"
    }, {
        "adImpact": 38339,
        "iab": "Arts & Entertainment>Television"
    }, {
        "adImpact": 26657,
        "iab": "Automotive"
    }, {
        "adImpact": 13953,
        "iab": "Technology & Computing"
    }],
    "requestParameters": {
        "advertiserId": "cnn.com"
    },
    "statusCode": 200,
    "recommendedPublishers": [{
        "advertisers": [{
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "cafemom.com"
        }, {
            "advertiserId": "tbs.com"
        }, {
            "advertiserId": "highincomerealestate.com"
        }, {
            "advertiserId": "apple.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "thepostgame.com"
        }, {
            "advertiserId": "legalzoom.com"
        }, {
            "advertiserId": "swimoutlet.com"
        }],
        "publisherId": "tmz.com",
        "publisherSize": 6745
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "cafemom.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "highincomerealestate.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "bloomberg.com"
        }, {
            "advertiserId": "thepostgame.com"
        }],
        "publisherId": "nbcsports.com",
        "publisherSize": 6382
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "cafemom.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "bloomberg.com"
        }, {
            "advertiserId": "thepostgame.com"
        }],
        "publisherId": "mytopfreegames.com",
        "publisherSize": 5926
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "cafemom.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "bloomberg.com"
        }],
        "publisherId": "retroogames.com",
        "publisherSize": 4288
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "cafemom.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "bloomberg.com"
        }, {
            "advertiserId": "thepostgame.com"
        }],
        "publisherId": "nationalreview.com",
        "publisherSize": 4069
    }, {
        "advertisers": [{
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "si.com"
        }, {
            "advertiserId": "beatsbydre.com"
        }, {
            "advertiserId": "nexplanon-usa.com"
        }, {
            "advertiserId": "blackberry.com"
        }, {
            "advertiserId": "sas.com"
        }, {
            "advertiserId": "mayoclinic.org"
        }, {
            "advertiserId": "legalzoom.com"
        }, {
            "advertiserId": "swimoutlet.com"
        }],
        "publisherId": "answers.com",
        "publisherSize": 3967
    }, {
        "advertisers": [{
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "cafemom.com"
        }, {
            "advertiserId": "si.com"
        }, {
            "advertiserId": "beatsbydre.com"
        }, {
            "advertiserId": "howlifeworks.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "thepostgame.com"
        }, {
            "advertiserId": "firsttoknow.com"
        }],
        "publisherId": "inquisitr.com",
        "publisherSize": 3948
    }, {
        "advertisers": [{
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "howlifeworks.com"
        }, {
            "advertiserId": "blackberry.com"
        }, {
            "advertiserId": "lincoln.com"
        }, {
            "advertiserId": "legalzoom.com"
        }],
        "publisherId": "aol.com",
        "publisherSize": 2672
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "highincomerealestate.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "thepostgame.com"
        }, {
            "advertiserId": "sas.com"
        }],
        "publisherId": "theweek.com",
        "publisherSize": 2352
    }, {
        "advertisers": [{
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "food.com"
        }, {
            "advertiserId": "nexplanon-usa.com"
        }, {
            "advertiserId": "apple.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "swimoutlet.com"
        }],
        "publisherId": "people.com",
        "publisherSize": 2309
    }],
    "phrases": [{
        "phrase": "cnn money"
    }, {
        "phrase": "young millionaire"
    }, {
        "phrase": "millionaire"
    }, {
        "phrase": "redford"
    }, {
        "phrase": "cnn"
    }, {
        "phrase": "tunein"
    }, {
        "phrase": "bourdain"
    }, {
        "phrase": "pga"
    }, {
        "phrase": "si swimsuit"
    }, {
        "phrase": "swimsuit"
    }, {
        "phrase": "embolism"
    }, {
        "phrase": "pereira"
    }, {
        "phrase": "cnnmoney"
    }, {
        "phrase": "cuomo"
    }, {
        "phrase": "reimagine"
    }, {
        "phrase": "illustrate"
    }, {
        "phrase": "akes"
    }, {
        "phrase": "tbs"
    }, {
        "phrase": "michaela"
    }, {
        "phrase": "journalism"
    }, {
        "phrase": "tonight"
    }, {
        "phrase": "oscar"
    }, {
        "phrase": "robert"
    }, {
        "phrase": "tune"
    }, {
        "phrase": "kate"
    }, {
        "phrase": "captivity"
    }, {
        "phrase": "weekday"
    }, {
        "phrase": "alex"
    }, {
        "phrase": "sund"
    }, {
        "phrase": "touchs"
    }],
    "recommendedChannels": [{
        "advertisers": [{
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "si.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "beatsbydre.com"
        }, {
            "advertiserId": "howlifeworks.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "legalzoom.com"
        }],
        "publisherId": "gma.yahoo.com",
        "publisherSize": 5282
    }, {
        "advertisers": [{
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "si.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "beatsbydre.com"
        }, {
            "advertiserId": "tbs.com"
        }, {
            "advertiserId": "howlifeworks.com"
        }, {
            "advertiserId": "apple.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "swimoutlet.com"
        }],
        "publisherId": "tv.yahoo.com",
        "publisherSize": 4144
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "cafemom.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "apple.com"
        }, {
            "advertiserId": "bloomberg.com"
        }, {
            "advertiserId": "thepostgame.com"
        }, {
            "advertiserId": "sas.com"
        }],
        "publisherId": "investing.businessweek.com",
        "publisherSize": 3128
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "si.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "beatsbydre.com"
        }, {
            "advertiserId": "highincomerealestate.com"
        }, {
            "advertiserId": "nexplanon-usa.com"
        }, {
            "advertiserId": "howlifeworks.com"
        }, {
            "advertiserId": "blackberry.com"
        }, {
            "advertiserId": "nexplanon.com"
        }, {
            "advertiserId": "mayoclinic.org"
        }, {
            "advertiserId": "firsttoknow.com"
        }, {
            "advertiserId": "legalzoom.com"
        }, {
            "advertiserId": "swimoutlet.com"
        }],
        "publisherId": "(education) about.com",
        "publisherSize": 2545
    }, {
        "advertisers": [{
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "beatsbydre.com"
        }, {
            "advertiserId": "blackberry.com"
        }, {
            "advertiserId": "apple.com"
        }, {
            "advertiserId": "bloomberg.com"
        }, {
            "advertiserId": "legalzoom.com"
        }, {
            "advertiserId": "swimoutlet.com"
        }],
        "publisherId": "answers.yahoo.com",
        "publisherSize": 2318
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "highincomerealestate.com"
        }, {
            "advertiserId": "nexplanon-usa.com"
        }, {
            "advertiserId": "howlifeworks.com"
        }, {
            "advertiserId": "blackberry.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "nexplanon.com"
        }, {
            "advertiserId": "firsttoknow.com"
        }, {
            "advertiserId": "legalzoom.com"
        }, {
            "advertiserId": "swimoutlet.com"
        }],
        "publisherId": "(compute) about.com",
        "publisherSize": 2069
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "highincomerealestate.com"
        }, {
            "advertiserId": "food.com"
        }, {
            "advertiserId": "nexplanon-usa.com"
        }, {
            "advertiserId": "howlifeworks.com"
        }, {
            "advertiserId": "firsttoknow.com"
        }, {
            "advertiserId": "legalzoom.com"
        }, {
            "advertiserId": "swimoutlet.com"
        }, {
            "advertiserId": "clicksor.com"
        }],
        "publisherId": "(money) about.com",
        "publisherSize": 1760
    }, {
        "advertisers": [{
            "advertiserId": "wealthfront.com"
        }, {
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "si.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "beatsbydre.com"
        }, {
            "advertiserId": "food.com"
        }, {
            "advertiserId": "nexplanon-usa.com"
        }, {
            "advertiserId": "howlifeworks.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "nexplanon.com"
        }, {
            "advertiserId": "mayoclinic.org"
        }, {
            "advertiserId": "firsttoknow.com"
        }, {
            "advertiserId": "legalzoom.com"
        }, {
            "advertiserId": "swimoutlet.com"
        }],
        "publisherId": "(food) about.com",
        "publisherSize": 1667
    }, {
        "advertisers": [{
            "advertiserId": "instyle.com"
        }, {
            "advertiserId": "cafemom.com"
        }, {
            "advertiserId": "si.com"
        }, {
            "advertiserId": "bankrate.com"
        }, {
            "advertiserId": "food.com"
        }, {
            "advertiserId": "thescene.com"
        }, {
            "advertiserId": "bloomberg.com"
        }, {
            "advertiserId": "lincoln.com"
        }],
        "publisherId": "tv.msn.com",
        "publisherSize": 1191
    }, {
        "advertisers": [{
            "advertiserId": "fool.com"
        }, {
            "advertiserId": "blackberry.com"
        }, {
            "advertiserId": "lincoln.com"
        }, {
            "advertiserId": "legalzoom.com"
        }],
        "publisherId": "autos.aol.com",
        "publisherSize": 1105
    }],
    "handler": "advertiserInfo",
    "advertiserId": "cnn.com"
}