Microsoft Ad Library API (beta)

Find ads by

• —Keyword (q)
• —Advertiser name (advertiser=…)
• —Advertiser id (advertiser=microsoft:{id})
• —Domain (domain=…): the brand name, kept when the landing URL is on the domain
• —Ad id (GET /v1/ads/microsoft:{id})
• —Our archive (source=history)

Filters

• —country: EU countries, IS, LI and NO
• —from / to

Only for ads shown in the EU

Published under the Digital Services Act; see EU reach.

• —impressions_range: total impressions range
• —countries and extra.impression_share_by_country: share of impressions per country
• —eu_data.targeting.other: targeting types used or excluded (age, gender, location, microsoft_audiences, advertiser_audiences)
• —eu_data.payer: paid for by
• —On the ad detail (GET /v1/ads/{id}), not in search results

What Microsoft Bing does not publish

• —Spend and reach: null
• —The values of the targeting: only which types were used
• —An active flag: status is always unknown
• —Beneficiary separate from the payer

What to do with it

• —See a competitor's Bing search ads with headline, text and landing page.
• —Compare a brand's Bing ads with its Google search ads.

Limits

• —Beta: Microsoft's library often answers with service limits or timeouts right now.
• —Cross-platform search skips Microsoft; ask for it with platform=microsoft.
• —Microsoft returns at most 1,000 results per query.
• —Dates, impressions, countries and targeting need the ad detail, one call per ad.