This method returns complete information about advertiser activity. Results can be filtered by using query parameters.
http://api.adbeat.com/v3/{api-key}/advertiserMetrics
http://api.adbeat.com/v3/{api-key}/advertiserMetrics/{advertiserId}
| Parameter Name | Meaning | Default Value | Notes |
|---|---|---|---|
| advertiserId | advertiser filter | (no filtering) | Restrict search to just one advertiser. Must use advertiser’s domain name. Use all to return aggregated results across all advertisers. |
| 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) |
| networkId | network filter | (no filtering) | Restrict search to one or more networks. (See networks). To specify multiple values, separate them by commas (e.g. adblade,google). Use all to return aggregated results across all networks. |
| publisherId | publisher filter | (no filtering) | Restrict search to just one publisher. Must use publisher’s (or channel’s) domain name. Use all to return aggregated results across all publishers. |
| categoryId | category filter | (no filtering) | Restrict search to advertisers that fall somewhere in the specified category path or below. For example: &categoryId=/finance/personal finance will return advertisers categorized as "/finance/personal finance" along with advertisers that belong to any subcategories like "/finance/personal finance/insurance", "/finance/personal finance/insurance/homeowners insurance", "/finance/personal finance/debt management", etc. |
| firstSeen | first seen filter | (no filtering) | Restrict search to advertisers whose ads were first seen (over the past 2 years) on the specified date or within the specified date range. Maximum date range span is 8 days. (See date and date range format) |
| sortBy | sorting field | adMetric | Other options: firstSeen, lastSeen, daysSeen, categoryScoreThenImpact (Note: If categoryScoreThenImpact is specified, you must also specify the &categoryId=xxx parameter) |
| sortOrder | sorting order | desc | Other options: asc |
| adMetricId | Format for ad metric data | adImpact | Other options: adSpend |
| isChannel | channel vs. publisher filter | (no filtering) | Restrict search to either channels true or publishers (any other value). |
| publisherPld | publisher PLD filter | (no filtering) | Restrict search to just one publisher "paid-level domain" (i.e., return hits matching this publisher and all of its channels). Must use publisher's domain name. |
| numAdMetricDays | Number of daily ad metrics to return | 0 | Includes this many days up to and including the latest data. Maximum 730. |
| maxPlacementUrls | Maximum number of placement URLs to return | 0 | Return up to this many placement URLs for each hit. Maximum 100. Note: Each placementURL returned will cost 1 API unit. |
| rows | Number of results to return | 10 | Maximum 1000. (Maximum sum of &start + &rows is 2000) |
| start | Index of first result to return | 0 | Use start=N (where N > 0) to page through results by making repeated requests. (Maximum sum of &start + &rows is 2000) |
| fields | fields filter | (no filtering) | Restrict which fields get returned. e.g. &fields=advertiserId would return just one of the available fields. &fields=advertiserId,publisherId would return just two of the available fields. |
| Field Name | Example | Notes |
|---|---|---|
| advertiserId | cnn.com | Advertiser domain name |
| countryId | us | See countries |
| platformId | desktop | See platforms |
| publisherPld | about.com | "Paid-level domain" of this channel. Only present if &isChannel is also true. |
| hasChannels | true | Contains true if hit is a publisher that has has been divided into channels. |
| isChannel | true | Contains true if hit is for a channel within a publisher. |
| isSuperChannel | true | Contains true if hit is for a "super channel" within a publisher having so many subdomains that each super channel refers to a portion of these subdomains. Only present if isChannel is also true. |
| networkId | See networks | |
| publisherId | huffingtonpost.com | Publisher domain name. (See Historical Data for how we handle older data) |
| categoryIds |
[{
"categoryId": "/technology and computing/internet technology/email",
"score": 1.0E-6
}, {
"categoryId": "/technology and computing/internet technology/web search",
"score": 1.0E-6
}, {
"categoryId": "/technology and computing/internet technology/social network",
"score": 1.0E-6
}]
|
Category IDs for this advertiser. Only returned when &platformId=all, &publisherId=all, and &networkId=all are set. Not returned for &advertiserId=all |
| firstSeen | 2012-12-05 | Date on which advertiser’s first ad was published (over the past 2 years) Only present when &firstSeen is a date range. (See Response Format) |
| lastSeen | 2012-12-10 | Date on which advertiser’s most recent ad was published |
| daysSeen | 3 | Number of days on which at least one of the advertiser’s ads was seen over the past two years |
| adCountsUnique |
{
"30": 44,
"90": 59,
"180": 65,
"365": 67,
"730": 78
}
|
Unique ad count totals for the most recent 30,90,180,365 and 730 days. |
| publisherCountsUnique |
{
"30": 5,
"90": 7,
"180": 8,
"365": 10,
"730": 12
}
|
Unique publisher count totals for the most recent 30,90,180,365 and 730 days. |
| adImpacts |
{
"30": 504512,
"90": 529024,
"180": 529024,
"365": 529024,
"730": 529024
}
|
Ad impact totals for the most recent 30,90,180,365 and 730 days. Only present for &adMetricId=adImpact. |
| adSpends |
{
"30": 12613,
"90": 13226,
"180": 13226,
"365": 13226,
"730": 13226
}
|
Ad spend totals (in US dollars) for the most recent 30,90,180,365 and 730 days. Only present for &adMetricId=adSpend. |
| adTypeImpacts |
{
"text": 129024,
"image": 100000,
"textimg": 50000,
"flash": 250000
}
|
Ad impact totals over the past 730 days by ad type. Only present for &adMetricId=adImpact. |
| adTypeSpends |
{
"text": 3226,
"image": 2000,
"textimg": 1000,
"flash": 7000
}
|
Ad spend totals over the past 730 days by ad type. Only present for &adMetricId=adSpend. |
| adSizeImpacts |
{
"300x250": 129024,
"728x90": 100000,
"300x600": 50000,
"200x200": 250000
}
|
Ad impact totals over the past 730 days by ad image size. Only present for &adMetricId=adImpact. |
| adSizeSpends |
{
"300x250": 3226,
"728x90": 2000,
"300x600": 1000,
"200x200": 7000
}
|
Ad send totals over the past 730 days by ad image size. Only present for &adMetricId=adSpend. |
| adImpactsDaily |
{
"firstDate": "2012-12-01",
"adImpacts": [
10405,
9887,
12543,
11332,
12908,
15673,
10943,
13763,
10952,
11722
]
}
|
Ad impact totals for each day up to and including the latest data. Only present for &adMetricId=adImpact and when &numAdMetricDays is also provided. |
| adSpendsDaily |
{
"firstDate": "2012-12-01",
"adSpends": [
260,
247,
314,
283,
323,
392,
274,
344,
274,
293
]
}
|
Ad spend totals (in US dollars) for each day up to and including the latest data. Only present for &adMetricId=adSpend and when &numAdMetricDays is also provided. |
| adTrends |
{
"30": -75,
"90": 150
}
|
See adTrends Values |
| adCountsUniqueDaily |
{
"firstDate": "2012-12-01",
"adCountsUnique": {
104, 98, 125, 113, 129, 156, 109, 137, 109, 117
}
}
|
Unique ad count totals for each day up to and including the target date of the indexes. Only present when &numAdMetricDays is provided. |
| publisherCountsUniqueDaily |
{
"firstDate": "2012-12-01",
"publisherCountsUnique": {
10, 9, 12, 11, 12, 15, 10, 13, 10, 11
}
}
|
Unique publisher count totals for each day up to and including the target date of the indexes. Only present when &numAdMetricDays is provided. Note that unless &publisherId=all is also provided, the results will not be particularly useful (i.e., when each hit refers to just one specific publisher, the publisherCountsUnique field will contain date-specific elements of 0 or 1). |
| placementUrls |
[{
"url": "http://www.huffingtonpost.com/events.html",
"adImpact": 529024
}, {
"url": "http://www.huffingtonpost.com/media.html",
"adImpact": 504512
}]
|
Each URL is returned with its ad impact/spend totals for the date range matching &sortBy (default 730 days). Only present for &maxPlacementUrls > 0 (and neither &advertiserId nor &publisherId can be "all"). If &adMetricId=adSpend, then the adImpact field will be replaced with adSpend. Note: Each placementURL returned will cost 1 API unit. |
| apiUnits | 150 | The number of API units consumed by this request. |
google network (sorted by "ad impact") do this:http://api.adbeat.com/v3/{api-key}/advertiserMetrics/?networkId=google
{
"statusCode": 200,
"numHits": 127389648,
"hits": [{
"countryId": "cn",
"lastSeen": "2015-07-21",
"publisherId": "china.com.cn",
"adCountsUnique": {
"365": 0,
"180": 0,
"30": 0,
"90": 0,
"730": 268
},
"hasChannels": false,
"daysSeen": 145,
"platformId": "desktop",
"adSizeImpacts": {
"other": 102465,
"300x250": 354250272
},
"adTrends": {
"30": 0,
"90": 0
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 0,
"180": 0,
"30": 0,
"90": 0,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 0,
"180": 0,
"30": 0,
"90": 0,
"730": 354351104
},
"adTypeImpacts": {
"image": 354352736
},
"advertiserId": "tanx.com",
"firstSeen": "2014-08-29"
}, {
"countryId": "us",
"lastSeen": "2016-08-11",
"publisherId": "printable-coupons.blogspot.com",
"adCountsUnique": {
"365": 66,
"180": 37,
"30": 11,
"90": 21,
"730": 163
},
"hasChannels": false,
"daysSeen": 614,
"platformId": "desktop",
"adSizeImpacts": {
"other": 68799,
"728x90": 3372433,
"468x60": 171686,
"300x600": 1696263,
"300x250": 80150760
},
"adTrends": {
"30": -71,
"90": -99
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 6343680,
"180": 3980800,
"30": 1958,
"90": 178656,
"730": 122304512
},
"adTypeImpacts": {
"text": 36832556,
"image": 85459904
},
"advertiserId": "shopathome.com",
"firstSeen": "2014-08-14"
}, {
"countryId": "us",
"lastSeen": "2015-06-10",
"publisherId": "blogspot.com",
"adCountsUnique": {
"365": 0,
"180": 0,
"30": 0,
"90": 0,
"730": 203
},
"hasChannels": true,
"daysSeen": 290,
"platformId": "desktop",
"adSizeImpacts": {
"336x280": 202422,
"125x125": 426,
"728x90": 2431799,
"468x60": 171686,
"300x250": 81230536,
"300x600": 83693,
"120x600": 4775,
"160x600": 355995
},
"adTrends": {
"30": 0,
"90": 0
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 0,
"180": 0,
"30": 0,
"90": 0,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 0,
"180": 0,
"30": 0,
"90": 0,
"730": 116406272
},
"adTypeImpacts": {
"text": 31918864,
"image": 84481360
},
"advertiserId": "shopathome.com",
"firstSeen": "2014-08-14"
}, {
"countryId": "us",
"lastSeen": "2016-08-07",
"publisherId": "urbandictionary.com",
"adCountsUnique": {
"365": 3,
"180": 3,
"30": 2,
"90": 3,
"730": 25
},
"hasChannels": false,
"daysSeen": 316,
"platformId": "desktop",
"adSizeImpacts": {
"other": 13781,
"728x90": 109871,
"300x600": 87687728,
"300x250": 414634,
"160x600": 361908
},
"adTrends": {
"30": 20000,
"90": -85
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 1480448,
"180": 1480448,
"30": 35368,
"90": 264768,
"730": 88586240
},
"adTypeImpacts": {
"image": 88587888
},
"advertiserId": "noisebot.com",
"firstSeen": "2014-08-14"
}, {
"countryId": "us",
"lastSeen": "2016-08-04",
"publisherId": "playbuzz.com",
"adCountsUnique": {
"365": 23,
"180": 8,
"30": 4,
"90": 8,
"730": 153
},
"hasChannels": false,
"daysSeen": 363,
"platformId": "androidTablet",
"adSizeImpacts": {
"other": 60604,
"728x90": 222489,
"300x600": 40318480,
"300x250": 38778124
},
"adTrends": {
"30": 20000,
"90": -96
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 853376,
"180": 121776,
"30": 4143,
"90": 121776,
"730": 85112832
},
"adTypeImpacts": {
"text": 5640762,
"html5": 114607,
"image": 79354128
},
"advertiserId": "google.com",
"firstSeen": "2014-08-14"
}, {
"countryId": "us",
"lastSeen": "2016-08-10",
"publisherId": "getitfree.us",
"adCountsUnique": {
"365": 113,
"180": 55,
"30": 9,
"90": 33,
"730": 406
},
"hasChannels": false,
"daysSeen": 610,
"platformId": "desktop",
"adSizeImpacts": {
"336x280": 2104729,
"320x50": 1901,
"other": 2557,
"728x90": 131388,
"468x60": 307960,
"300x250": 72986816
},
"adTrends": {
"30": -85,
"90": 311
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 918656,
"180": 280256,
"30": 65328,
"90": 123920,
"730": 79017984
},
"adTypeImpacts": {
"flash": 1609061,
"text": 3493634,
"html5": 109518,
"image": 73816872
},
"advertiserId": "google.com",
"firstSeen": "2014-08-14"
}, {
"countryId": "jp",
"lastSeen": "2016-08-12",
"publisherId": "goo.ne.jp",
"adCountsUnique": {
"365": 121,
"180": 84,
"30": 2,
"90": 21,
"730": 193
},
"hasChannels": false,
"daysSeen": 573,
"platformId": "desktop",
"adSizeImpacts": {
"336x280": 406812,
"250x250": 58963,
"other": 96584,
"728x90": 239676,
"300x250": 15811338,
"200x200": 24276
},
"adTrends": {
"30": 20000,
"90": -99
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 18262016,
"180": 7574528,
"30": 17252,
"90": 1417984,
"730": 78559232
},
"adTypeImpacts": {
"text": 61914084,
"image": 16637650
},
"advertiserId": "yeay.jp",
"firstSeen": "2014-08-14"
}, {
"countryId": "tr",
"lastSeen": "2016-04-13",
"publisherId": "hurriyet.com.tr",
"adCountsUnique": {
"365": 1216,
"180": 427,
"30": 0,
"90": 0,
"730": 1217
},
"hasChannels": false,
"daysSeen": 223,
"platformId": "desktop",
"adSizeImpacts": {
"other": 32391,
"728x90": 12176492,
"takeover": 18849162,
"300x600": 1640013,
"300x250": 39699648,
"120x600": 576743,
"160x600": 1540529
},
"adTrends": {
"30": 0,
"90": 0
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 0,
"90": 0,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 74430464,
"180": 7412736,
"30": 0,
"90": 0,
"730": 74528768
},
"adTypeImpacts": {
"flash": 70124,
"html5": 401342,
"image": 74042520
},
"advertiserId": "medyanetads.com",
"firstSeen": "2015-08-08"
}, {
"countryId": "tr",
"lastSeen": "2015-11-24",
"publisherId": "milliyet.com.tr",
"adCountsUnique": {
"365": 17,
"180": 0,
"30": 0,
"90": 0,
"730": 1973
},
"hasChannels": false,
"daysSeen": 293,
"platformId": "desktop",
"adSizeImpacts": {
"other": 787541,
"728x90": 11475942,
"300x250": 46908092,
"300x600": 3540427,
"120x600": 4557035,
"160x600": 1076152
},
"adTrends": {
"30": 0,
"90": 0
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 0,
"30": 0,
"90": 0,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 2684416,
"180": 0,
"30": 0,
"90": 0,
"730": 68401152
},
"adTypeImpacts": {
"flash": 7902403,
"image": 60495020
},
"advertiserId": "crwdcntrl.net",
"firstSeen": "2014-08-14"
}, {
"countryId": "tr",
"lastSeen": "2016-08-12",
"publisherId": "haber7.com",
"adCountsUnique": {
"365": 9,
"180": 7,
"30": 3,
"90": 4,
"730": 9
},
"hasChannels": false,
"daysSeen": 240,
"platformId": "desktop",
"adSizeImpacts": {
"other": 65597072,
"728x90": 2378,
"300x250": 236215
},
"adTrends": {
"30": 40,
"90": 20000
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 65837056,
"180": 25921536,
"30": 8998912,
"90": 9396224,
"730": 65837056
},
"adTypeImpacts": {
"image": 65835648
},
"advertiserId": "halkbankkobi.com.tr",
"firstSeen": "2015-10-09"
}],
"apiUnits": 150,
"statusMsg": "successful advertiserMetrics request",
"requestParameters": {
"networkId": "google"
},
"handler": "advertiserMetrics"
}
facebook.com and limit the results to 5 rows of data, do this:http://api.adbeat.com/v3/{api-key}/advertiserMetrics/?advertiserid=facebook.com&rows=5
{
"statusCode": 200,
"numHits": 190747,
"hits": [{
"countryId": "br",
"lastSeen": "2016-08-04",
"publisherId": "globo.com",
"adCountsUnique": {
"365": 29,
"180": 16,
"30": 3,
"90": 9,
"730": 30
},
"networkId": "direct",
"hasChannels": false,
"daysSeen": 98,
"platformId": "desktop",
"adSizeImpacts": {
"other": 2876525,
"300x250": 38193300,
"interstitial": 315470
},
"adTrends": {
"30": -97,
"90": -46
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 39901184,
"180": 18286592,
"30": 2160128,
"90": 6784000,
"730": 41392128
},
"adTypeImpacts": {
"flash": 19153488,
"html5": 11555638,
"image": 10676157
},
"firstSeen": "2014-09-28"
}, {
"countryId": "us",
"lastSeen": "2016-08-12",
"publisherId": "dailycaller.com",
"adCountsUnique": {
"365": 8,
"180": 4,
"30": 2,
"90": 2,
"730": 12
},
"networkId": "google",
"hasChannels": false,
"daysSeen": 456,
"platformId": "desktop",
"adSizeImpacts": {
"728x90": 636955,
"300x250": 32129638
},
"adTrends": {
"30": 107,
"90": 4
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 5403648,
"180": 1727744,
"30": 340416,
"90": 958848,
"730": 32770048
},
"adTypeImpacts": {
"text": 5355,
"image": 32766596
},
"firstSeen": "2014-08-14"
}, {
"countryId": "us",
"lastSeen": "2016-08-12",
"publisherId": "stackexchange.com",
"adCountsUnique": {
"365": 2,
"180": 1,
"30": 1,
"90": 1,
"730": 2
},
"networkId": "direct",
"hasChannels": false,
"daysSeen": 74,
"platformId": "desktop",
"adSizeImpacts": {
"other": 4527420,
"300x250": 25585180
},
"adTrends": {
"30": -13,
"90": 966
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 30115840,
"180": 23717888,
"30": 4840448,
"90": 10579968,
"730": 30115840
},
"adTypeImpacts": {
"image": 30112608
},
"firstSeen": "2015-12-19"
}, {
"countryId": "us",
"lastSeen": "2015-08-10",
"publisherId": "games.com",
"adCountsUnique": {
"365": 0,
"180": 0,
"30": 0,
"90": 0,
"730": 92
},
"networkId": "direct",
"hasChannels": false,
"daysSeen": 268,
"platformId": "desktop",
"adSizeImpacts": {
"728x90": 4727576,
"300x250": 11376268,
"160x600": 4925974
},
"adTrends": {
"30": 0,
"90": 0
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 0,
"180": 0,
"30": 0,
"90": 0,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 0,
"180": 0,
"30": 0,
"90": 0,
"730": 21030912
},
"adTypeImpacts": {
"image": 21029860
},
"firstSeen": "2014-10-09"
}, {
"countryId": "tr",
"lastSeen": "2016-08-12",
"publisherId": "instela.com",
"adCountsUnique": {
"365": 33,
"180": 7,
"30": 7,
"90": 7,
"730": 33
},
"networkId": "google",
"hasChannels": false,
"daysSeen": 98,
"platformId": "desktop",
"adSizeImpacts": {
"320x50": 222763,
"other": 137967,
"300x250": 18842292,
"300x600": 320047
},
"adTrends": {
"30": -14,
"90": 20000
},
"categoryIds": [],
"publisherCountsUnique": {
"365": 1,
"180": 1,
"30": 1,
"90": 1,
"730": 1
},
"isChannel": false,
"adImpacts": {
"365": 19580928,
"180": 297920,
"30": 297920,
"90": 297920,
"730": 19580928
},
"adTypeImpacts": {
"text": 59280,
"image": 19523120
},
"firstSeen": "2015-09-15"
}],
"apiUnits": 125,
"statusMsg": "successful advertiserMetrics request",
"requestParameters": {
"advertiserid": "facebook.com",
"rows": "5"
},
"handler": "advertiserMetrics"
}