This method returns data about a specific advertiser. To use this method, you need to pass a specific advertiserId (domain name).
http://api.adbeat.com/v3/{api-key}/advertiserInfo/{advertiserId}
| 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 |
| 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. |
cnn.com do this:http://api.adbeat.com/v3/{api-key}/advertiserInfo/cnn.com
{
"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"
}