---
type: "firecrawl-provider"
description: "Bing search ads from Microsoft's public Ad Library: advertisers, their ads, and each ad's dates, EU impressions and targeting."
use_when: "Microsoft Advertising advertisers by name or id.\n\nBing search ads that served in the EU and EEA, by advertiser or ad text, and one ad's dates, impressions and targeting."
categories: "Marketing"
capabilities: 4
credits_per_call: "1-2"
---
# Microsoft Ad Library on Firecrawl Alexandria

Bing search ads from Microsoft's public Ad Library: advertisers, their ads, and each ad's dates, EU impressions and targeting.

- Categories: Marketing
- Category index: [Marketing category](https://alexandria.firecrawl.dev/agents/categories/marketing)
- Provider key: `microsoft-ad-library`
- Access: Firecrawl credits
- Cost: 1–2 credits per call

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/microsoft-ad-library)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/microsoft-ad-library/openapi.json)

## Capabilities

- [Find Bing advertisers by name](https://alexandria.firecrawl.dev/agents/providers/microsoft-ad-library/advertisers/search): Advertisers under value. @odata.count is the total number of matches.
- [Bing advertiser by id](https://alexandria.firecrawl.dev/agents/providers/microsoft-ad-library/advertisers/get): One advertiser.
- [Bing ads by advertiser or text](https://alexandria.firecrawl.dev/agents/providers/microsoft-ad-library/ads/search): Ads under value. @odata.count is the total number of matching ads.
- [Bing ad details](https://alexandria.firecrawl.dev/agents/providers/microsoft-ad-library/ads/get): One ad with AdDetails.

## 1. Choose this provider when

Microsoft Advertising advertisers by name or id.

Bing search ads that served in the EU and EEA, by advertiser or ad text, and one ad's dates, impressions and targeting.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "microsoft-ad-library",
  "capability": "advertisers/search",
  "options": {
    "searchText": "<searchText>",
    "top": 3,
    "skip": 0
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `searchText` (string, required): Advertiser name to search for, such as Lovable. Example: `<searchText>`
- `top` (number): Advertisers per page, 1 to 24. The API defaults to 3. Example: `3`
- `skip` (number): Advertisers to skip, for the next page. Example: `0`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "microsoft-ad-library",
    capability: "advertisers/search",
    options: {
      searchText: "<searchText>",
      top: 3,
      skip: 0,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "microsoft-ad-library",
  "capability": "advertisers/search",
  "options": {
    "searchText": "<searchText>",
    "top": 3,
    "skip": 0
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "microsoft-ad-library",
    "capability": "advertisers/search",
    "options": {
      "searchText": "<searchText>",
      "top": 3,
      "skip": 0
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'microsoft-ad-library/advertisers/search' \
  --options '{"searchText":"<searchText>","top":3,"skip":0}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "microsoft-ad-library",
  "capability": "advertisers/search",
  "options": {
    "searchText": "<searchText>",
    "top": 3,
    "skip": 0
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "microsoft-ad-library",
  "capability": "advertisers/search",
  "options": {
    "searchText": "<searchText>",
    "top": 3,
    "skip": 0
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "value": [
    {
      "AdvertiserId": 0,
      "AdvertiserName": "<AdvertiserName>",
      "AdvertiserCountry": "<AdvertiserCountry>",
      "IsVerified": false
    }
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Find Bing advertisers by name

- Capability: `advertisers/search`
- Description: Advertisers under value. @odata.count is the total number of matches.
- Instructions: Find the Microsoft Advertising advertiser id for a company name, before listing its Bing ads with ads/search. Several companies can share a name, so check AdvertiserCountry and IsVerified. 2 credits per call.
- Cost: 1 credit per call
- Capability file: [Find Bing advertisers by name](https://alexandria.firecrawl.dev/agents/providers/microsoft-ad-library/advertisers/search)

Accepted options:
- `searchText` (string, required): Advertiser name to search for, such as Lovable. Example: `<searchText>`
- `top` (number): Advertisers per page, 1 to 24. The API defaults to 3. Example: `3`
- `skip` (number): Advertisers to skip, for the next page. Example: `0`

Response schema example:
```json
{
  "value": [
    {
      "AdvertiserId": 0,
      "AdvertiserName": "<AdvertiserName>",
      "AdvertiserCountry": "<AdvertiserCountry>",
      "IsVerified": false
    }
  ]
}
```

### Bing advertiser by id

- Capability: `advertisers/get`
- Description: One advertiser.
- Instructions: Read one Microsoft Advertising advertiser by id. A verified account id answers with its parent verified advertiser id. 2 credits per call.
- Cost: 1 credit per call
- Capability file: [Bing advertiser by id](https://alexandria.firecrawl.dev/agents/providers/microsoft-ad-library/advertisers/get)

Accepted options:
- `advertiserId` (string, required): Advertiser id from advertisers/search, such as 4295350120. Example: `<advertiserId>`

Response schema example:
```json
{
  "@odata.context": "<@odata.context>",
  "AdvertiserId": 0,
  "AdvertiserName": "<AdvertiserName>",
  "AdvertiserCountry": "<AdvertiserCountry>",
  "IsVerified": false
}
```

### Bing ads by advertiser or text

- Capability: `ads/search`
- Description: Ads under value. @odata.count is the total number of matching ads.
- Instructions: List the Bing search ads an advertiser ran in the EU and EEA, or ads whose copy matches some words: headline, description, display and destination URL. Dates and impressions are not on this list; read one ad with ads/get for them. @odata.count is the total, so one call sizes an advertiser's ad count. 3 credits per call.
- Cost: 2 credits per call
- Capability file: [Bing ads by advertiser or text](https://alexandria.firecrawl.dev/agents/providers/microsoft-ad-library/ads/search)

Accepted options:
- `advertiserId` (string): Advertiser id from advertisers/search. Example: `<advertiserId>`
- `searchText` (string): Words in the ad copy. Example: `<searchText>`
- `startDate` (string): Only ads that served on or after this date, YYYY-MM-DD. Example: `<startDate>`
- `endDate` (string): Only ads that served on or before this date, YYYY-MM-DD. Example: `<endDate>`
- `countryCodes` (string): Comma-separated EU or EEA country values from the docs, such as 72 for Germany or 66,72 for France and Germany. Not ISO codes. Example: `<countryCodes>`
- `top` (number): Ads per page, 1 to 24. The API defaults to 12. Example: `12`
- `skip` (number): Ads to skip, for the next page. Example: `0`

Response schema example:
```json
{
  "value": [
    {
      "AdId": 0,
      "AdvertiserId": 0,
      "AdvertiserName": "<AdvertiserName>",
      "Title": "<Title>",
      "Description": "<Description>",
      "DisplayUrl": "<DisplayUrl>",
      "DestinationUrl": "<DestinationUrl>",
      "AssetJson": "<AssetJson>"
    }
  ]
}
```

### Bing ad details

- Capability: `ads/get`
- Description: One ad with AdDetails.
- Instructions: Read one Bing ad with its details: first and last date it served in the EU or EEA, its total EU impressions as a range (such as 500K - 1M), its share of impressions by country, and the targeting types used. 2 credits per call.
- Cost: 1 credit per call
- Capability file: [Bing ad details](https://alexandria.firecrawl.dev/agents/providers/microsoft-ad-library/ads/get)

Accepted options:
- `adId` (string, required): Ad id from ads/search. Example: `<adId>`

Response schema example:
```json
{
  "@odata.context": "<@odata.context>",
  "AdId": 0,
  "AdvertiserId": 0,
  "AdvertiserName": "<AdvertiserName>",
  "Title": "<Title>",
  "Description": "<Description>",
  "DisplayUrl": "<DisplayUrl>",
  "DestinationUrl": "<DestinationUrl>",
  "AssetJson": "<AssetJson>",
  "AdDetails": {}
}
```
