Bing Ads Library Scraper — Microsoft Ads Transparency & Competitor Ad Library API

Scrape the Microsoft / Bing Ads Library (adlibrary.ads.microsoft.com) into clean, filterable JSON or CSV. Search by advertiser name, advertiser ID, or ad-copy keyword, and pull every ad an advertiser is running on Bing — title, description, display & destination URLs, creative assets, and (optionally) per-ad impressions and targeting. Built for competitor ad research, ad monitoring, and AI agents that need Bing ad transparency data on tap.

Keywords: bing ads library, microsoft ads transparency, bing ads scraper, competitor ads bing, ad library api, microsoft advertising transparency, bing ad intelligence, competitor ad monitoring.

What it does

• Advertiser search — type a brand ("Nike", "Bosch") and get every advertiser match plus all their ads.
• Advertiser ID — pass an exact Microsoft advertiser ID and pull its complete ad set.
• Keyword — find ads whose copy (title/description) contains your terms.
• Filters — EEA country, date range, and an optional ad details enrichment (impressions range, impressions-by-country, targeting).
• Streams results live — rows are written to the dataset as each page arrives, so an interrupted run still keeps everything found so far.
• Company-level only — advertiser (funding-entity) name + ad creative metadata. No personal data.

Data source & scope

This actor uses Microsoft's official public Ad Library API (adlibrary.api.bingads.microsoft.com/api/v1), the same data behind the public Bing Ad Library site. The API is public and needs no login or API key.

Coverage: the European Economic Area (EEA) only. The Bing Ad Library is Microsoft's EU-compliance transparency tool, so it contains ads served within the EEA — not the US. If you need a specific EEA market, set country (e.g. DE, France, IE); otherwise it returns ads across the EEA.

Input

Field	Type	Description
searchMode	select	advertiser (name search, default), advertiserId (exact), or keyword (words in ad copy).
queries	array	Advertiser names, advertiser IDs, or keywords — must match searchMode.
country	string	EEA country name/code (e.g. DE, Germany, IE) or anywhere. Unknown → anywhere (never a wrong-country result).
dateFrom / dateTo	string	YYYY-MM-DD active-period bounds (applied when ad dates are available).
includeAdDetails	boolean	Fetch per-ad impressions range / by-country / targeting (one extra request per ad, slower). Default off.
maxResults	integer	Stop after N ads. Default 20 for a fast preview; 0 = no limit.

Example

{
  "searchMode": "advertiser",
  "queries": ["Nike"],
  "country": "DE",
  "maxResults": 50
}

Output

One row per ad (flat, predictable, agent-friendly):

{
  "advertiserName": "Contoso Retail GmbH",
  "advertiserId": "123456789",
  "advertiserCountry": "DE",
  "advertiserVerified": true,
  "adId": "AD-0001",
  "title": "Winter Sale — up to 40% off",
  "description": "Shop the Contoso winter collection. Free returns across the EEA.",
  "displayUrl": "contoso.de/winter",
  "destinationUrl": "https://www.contoso.de/winter-sale",
  "assetJson": "{\"images\":[{\"url\":\"https://…\"}]}",
  "firstShown": "2026-01-05",
  "lastShown": "2026-02-28",
  "totalImpressionsRange": "100000-150000",
  "impressionsByCountry": [ { "Country": "DE", "ImpressionsRange": "80000-120000" } ],
  "targets": { "AgeRanges": ["25-34"], "Genders": ["All"] },
  "adLibraryUrl": "https://adlibrary.ads.microsoft.com/ad-details?adId=AD-0001",
  "country": "DE",
  "matchedQuery": "Nike",
  "searchMode": "advertiser",
  "recordType": "ad",
  "source": "adlibrary.ads.microsoft.com",
  "scrapedAt": "2026-07-27T00:00:00.000Z"
}

firstShown / lastShown / totalImpressionsRange / impressionsByCountry / targets are populated only when includeAdDetails is on (the Ad Library exposes these on the single-ad endpoint).

For AI agents (MCP)

• Every input has a short, self-explanatory description; field names are literal.
• Default run is small and fast (maxResults: 20), so an agent can probe cheaply before a full pull.
• Output is a flat object with stable keys — no nested decoding needed for the common fields.

Notes

• Compliance: all data is advertiser/company-level (Microsoft requires ads to disclose the funding organisation). No personal data is collected.
• Rate limits: unauthenticated Ad Library calls are throttled by Microsoft; this actor retries with backoff and rotates IPs via Apify Proxy to stay reliable on larger pulls.