What's New

June 28, 2016 New in release 3.12 we're pleased to announce Adbeat now offers data on video ads (also known as "pre-roll"). Both the advertiserMetrics and adMetrics handlers now return video ad data.

adMetrics now returns both the imageUrl and videoUrl fields for video ads. It also now supports the &publisherPld and &isChannel parameters and returns the publisherPld, isChannel, isSuperChannel, and hasChannels fields for each hit.

June 15, 2016 In release 3.11, the networks handler now returns an isNative flag. Native ad networks include, Outbrain, Taboola, etc.

The adMetrics method now supports multiple comma-separated values to be passed via its &adTypeId parameter, allowing you to craft more complex queries.

May 11, 2016 New in release 3.10 The adMetrics handler now returns campaign information (and supports the &campaignId parameter) for &publisherId={specific} (as well as the omission of this parameter to return all publisher-specific hits).

There's also a new campaigns method that returns campaign name auto-completion results.

Mar 15, 2016 New in release 3.9 There is now a campaignMetrics handler that returns campaign-specific results (limited to &countryId=us).

The adMetrics handler now supports the &campaignId parameter and returns the campaign(s) for each hit. However, this support is currently limited to &publisherId=all and &countryId=us.

Jan 20, 2016 New in release 3.8 We've got more support for Advertiser categories. advertiserMetrics now supports the &sortBy=categoryScoreThenImpact value and, if specified, it returns results sorted first by category score and then by adImpact. If categoryScoreThenImpact is used as the &sortBy parameter value, you MUST specify a &categoryId=xxx parameter.

The advertiserMetrics handler also now supports platform specific and network specific queries for categories.

And finally, there's a new categories handler that returns category auto-completion results.

Oct 9, 2015 New in release 3.5 we've started adding support for Advertiser categories. advertiserMetrics supports a new &categoryId parameter that allows you to limit your results to specific categories. It also has a new return field categoryIds. This is just Phase I of our advertiser category support... more updates coming soon.

Aug 17, 2015 We've released a hotfix for 3.4.4 that allows you to go even deeper with your queries.

The maximum &rows value for advertiserMetrics and adMetrics has been increased from 100 to 1000. Furthermore, the maximum sum of &start+&rows has been increased to 2000.

Jul. 8, 2015 For release 3.4.4, we're pleased to announce two much requested features!

advertiserMetrics now supports a &maxPlacementUrls parameter. Setting this parameter along with specifying an &advertiserId and &publisherId will return the top placement URLs for the advertiser on that publisher.

adMetrics now supports a &destinationUrls parameter. Setting this parameter will return destination URLs in the response. (See docs for more details.)

Feb. 24, 2015 Two changes for release 3.1:

advertiserMetrics and publisherInfo now return a hasChannels field.

Jan. 30, 2015 We've added some new stuff for release 3.0, here ya go:

adMetrics now supports a new daysSeen option for &sortBy parameter.

adMetrics supports adTypeId and adSizeId options for &facetField parameter.

advertiserMetrics now supports a new daysSeen option for &sortBy parameter.

advertiserMetrics supports new parameters: &midAdimpact, &isChannel, and publisherPld.

advertiserMetrics the &advertiserId parameter no longer supports multiple values.

advertiserMetrics has new return values: publisherPld, isChannel, isSuperChannel, adTypeImpacts, adTypeSpends, adSizeImpacts, adSizeSpends, adCountsUniqueDaily, and publisherCountsUniqueDaily

advertiserInfo supports &adMetricId parameter.

advertiserInfo returns more data in recommendedChannels, recommendedPublishers, similarAdvertisers, and iabCategories return fields

publisherInfo returns more data in recommendedAdvertisers, and similarPublishers return fields

Aug. 21, 2014 We've improved the API to help you build more precise queries. We now support passing comma separated values (CSVs) for some useful parameters.

Most methods now support CSVs for &platformId

adMetrics supports CSVs for &adHash, &advertiserId, and &networkId

advertiserMetrics supports CSVs for &advertiserId and &networkId

We also now support a &facetField parameter in adMetrics which allows you to find out how many documents share the same value in a particular field.

Jun. 23, 2014 We've updated our Response Format to include a new apiUnits response field. This new field will return the number of API units a request consumes making it a handy way to keep track of your API usage.

Jun. 13, 2014 We've added a new adTrends field to the response of two methods: adMetrics and advertiserMetrics. This new adTrends field let you see how ad impact has changed during a specific time period. (See adTrends Values)

Jun. 9, 2014 We've added two new methods: advertiserEvents and eventTypes

Mar. 12, 2014 We've added a new &fields parameter to selected methods. This new parameter allows you to restrict which fields are returned in the results. See advertiserMetrics, adMetrics, adSizes, adTypes, countries, networks, platforms, adTerms, advertisers, publishers

Mar. 10, 2014 We now support &platformId=mobile in both adMetrics and advertiserMetrics. This new platformId aggregates data across all of iphone, ipad, android and androidTablet. See platforms for a list of all platforms we support.