Microsoft Ads Library Scraper

Scrape ads, advertisers, and ad details from the Microsoft Advertising Transparency Center (Bing Ads Library). Extract competitor ad copy, targeting data, impression stats, and advertiser information across all EU/EEA countries — no login or API key required.

What does Microsoft Ads Library Scraper do?

This actor lets you programmatically access the Microsoft Ads Library to extract advertising data served across the European Economic Area. Use it for competitive intelligence, market research, ad creative analysis, and compliance monitoring.

The Microsoft Ad Library is publicly available but has no bulk export. This actor handles pagination, proxy rotation, and structured data output so you can extract thousands of results in minutes.

Key features

• Search ads by keyword, advertiser ID, date range, or country
• Search advertisers by name to find their advertiser IDs
• Get full ad details including impression ranges, country breakdowns, and targeting parameters (gender, age, location, audiences)
• Automatic pagination — scrape up to 1,000 results per run
• Structured JSON output ready for analysis or integration
• Pay-per-event pricing — you only pay for the results you get

How to use

1. Search Ads

Find ads by keyword, advertiser, date range, or country. Great for monitoring competitor ad copy and discovering what ads are running in specific markets.

Input example:

{
  "mode": "searchAds",
  "searchAdText": "cloud computing",
  "countryCodes": ["66"],
  "startDate": "2025-01-01",
  "maxSearchResults": 100
}

Output example:

{
  "AdId": 83291234567,
  "AdvertiserName": "Contoso Ltd",
  "AdvertiserId": 4295212345,
  "Title": "Enterprise Cloud Computing Solutions",
  "Description": "Scale your business with secure cloud infrastructure. Start your free trial today.",
  "DisplayUrl": "contoso.com",
  "DestinationUrl": "https://www.contoso.com/cloud"
}

2. Search Advertisers

Look up advertisers by name to find their IDs, verification status, and registered country. Use the advertiser ID to then search for all their ads.

Input example:

{
  "mode": "searchAdvertisers",
  "searchAdvertiserText": "Microsoft",
  "maxSearchResults": 50
}

Output example:

{
  "AdvertiserId": 4295212599,
  "AdvertiserName": "Microsoft",
  "AdvertiserCountry": "United States",
  "IsVerified": true
}

3. Get Ad Details

Retrieve full details for specific ads by their IDs, including impression data, country-level impression breakdowns, and targeting parameters.

Input example:

{
  "mode": "getAdDetails",
  "adIds": ["83291234567", "83291234568"]
}

Output example:

{
  "AdId": 83291234567,
  "AdvertiserName": "Contoso Ltd",
  "AdvertiserId": 4295212345,
  "Title": "Enterprise Cloud Computing Solutions",
  "Description": "Scale your business with secure cloud infrastructure.",
  "DisplayUrl": "contoso.com",
  "DestinationUrl": "https://www.contoso.com/cloud",
  "AdDetails": {
    "StartDate": "2025-01-15",
    "EndDate": "2025-02-28",
    "TotalImpressionsRange": "10k - 50k",
    "ImpressionsByCountry": [
      { "Country": 66, "ImpressionShare": "45.2%" },
      { "Country": 72, "ImpressionShare": "30.1%" }
    ],
    "Targets": [
      { "TargetType": 2, "UsedForExclusion": false },
      { "TargetType": 3, "UsedForExclusion": false }
    ]
  }
}

Input schema

Field	Type	Description
mode	string	Required. One of searchAds, searchAdvertisers, or getAdDetails
maxSearchResults	integer	Maximum results to return (24–1,000). Default: 1,000
searchAdText	string	Keyword to search in ad content (for searchAds mode)
advertiserId	integer	Filter ads by advertiser ID (for searchAds mode)
startDate	string	Filter ads from this date, format YYYY-MM-DD (for searchAds mode)
endDate	string	Filter ads until this date, format YYYY-MM-DD (for searchAds mode)
countryCodes	array	Filter by EU/EEA country codes (for searchAds mode)
includeAdDetails	boolean	Also fetch full details for each ad found (for searchAds mode). Increases cost and runtime
searchAdvertiserText	string	Keyword to search in advertiser names (for searchAdvertisers mode)
adIds	array	List of ad IDs to retrieve details for (for getAdDetails mode)

Supported countries

Austria, Belgium, Bulgaria, Croatia, Cyprus, Czechia, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden.

Output

Results are pushed to the default dataset in structured JSON. The output schema depends on the mode:

• searchAds — returns Ad objects with AdId, AdvertiserName, AdvertiserId, Title, Description, DisplayUrl, DestinationUrl
• searchAdvertisers — returns Advertiser objects with AdvertiserId, AdvertiserName, AdvertiserCountry, IsVerified
• getAdDetails — returns Ad objects with full AdDetails including StartDate, EndDate, TotalImpressionsRange, ImpressionsByCountry, and Targets

You can download results in JSON, CSV, XML, or Excel format, or access them via the Apify API.

Use cases

• Competitive ad intelligence — Monitor what ads your competitors are running on Microsoft/Bing Search
• Market research — Discover which companies are advertising in specific markets or industries
• Ad creative analysis — Analyze ad copy, headlines, and landing pages at scale
• Compliance monitoring — Track advertiser verification status and ad transparency data
• Media buying research — Understand targeting strategies (age, gender, location, audiences) used by advertisers
• Trend analysis — Track advertising activity over time with date range filters

Important notes

• The Microsoft Ad Library only contains ads served in the EU and EEA since June 2023
• There may be a 1–3 day delay before new ads appear in the library
• The API is publicly available and does not require authentication
• Ad details (impressions, targeting) can only be retrieved for individual ads, not in bulk search results — use includeAdDetails or getAdDetails mode

Integrations

Connect Microsoft Ads Library Scraper with any cloud service or web app through integrations on the Apify platform. You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and more. Or you can use webhooks to carry out an action whenever an event occurs.

Using the Apify API

The Apify API lets you programmatically access the Apify platform. The API is organized around RESTful HTTP endpoints. All requests and responses (including errors) are encoded in JSON. You can retrieve results, manage runs, and integrate this actor into your pipeline. See the Apify API reference for full details.