---
type: "firecrawl-provider"
description: "Bing search ads on a live results page for any query and market."
use_when: "Paid results on a live Bing results page for one query and market."
categories: "Marketing"
capabilities: 1
credits_per_call: 2
---
# SearchApi on Firecrawl Alexandria

Bing search ads on a live results page for any query and market.

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

## More

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

## 1. Choose this provider when

Paid results on a live Bing results page for one query and market.

## 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": "searchapi",
  "capability": "bing/ads",
  "options": {
    "q": "<q>",
    "country_code": "US",
    "device": "desktop"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `q` (string, required): The search, such as a competitor's brand name or a category keyword like ai app builder. Example: `<q>`
- `country_code` (string): Country of the results, two letters. Defaults to US. Example: `US`
- `market_code` (string): Bing market, language-country, such as en-us. Example: `es-ar`
- `location` (string): City-level location, such as New York,United States. Example: `<location>`
- `device` (string): Desktop or mobile results. Example: `desktop`
- `page` (number): Results page, from 1. Ads mostly sit on page 1. Example: `5`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "searchapi",
    capability: "bing/ads",
    options: {
      q: "<q>",
      country_code: "US",
      device: "desktop",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "searchapi",
  "capability": "bing/ads",
  "options": {
    "q": "<q>",
    "country_code": "US",
    "device": "desktop"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "searchapi",
    "capability": "bing/ads",
    "options": {
      "q": "<q>",
      "country_code": "US",
      "device": "desktop"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'searchapi/bing/ads' \
  --options '{"q":"<q>","country_code":"US","device":"desktop"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "searchapi",
  "capability": "bing/ads",
  "options": {
    "q": "<q>",
    "country_code": "US",
    "device": "desktop"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "searchapi",
  "capability": "bing/ads",
  "options": {
    "q": "<q>",
    "country_code": "US",
    "device": "desktop"
  }
}
```

## 6. Response data

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

```json
{
  "ads": [
    {
      "position": 0,
      "block_position": "<block_position>",
      "title": "<title>",
      "link": "<link>",
      "displayed_link": "<displayed_link>",
      "tracking_link": "<tracking_link>",
      "snippet": "<snippet>",
      "source": "<source>",
      "sitelinks": {}
    }
  ]
}
```

## API reference-derived contract

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

### Bing search ads for a query

- Capability: `bing/ads`
- Description: Text ads under ads, in page order. shopping_ads holds product ads, and search_parameters echoes the query.
- Instructions: See the paid ads on a live Bing results page for one query in one market: who bids on it, their headline, description, displayed and destination links, and sitelinks. Run a company's brand and category keywords to find its US Bing ads; the Microsoft Ad Library only covers ads served in the EU. Organic results are not returned. 2 credits per call, including a page with no ads.
- Cost: 2 credits per call
- Capability file: [Bing search ads for a query](https://alexandria.firecrawl.dev/agents/providers/searchapi/bing/ads)

Accepted options:
- `q` (string, required): The search, such as a competitor's brand name or a category keyword like ai app builder. Example: `<q>`
- `country_code` (string): Country of the results, two letters. Defaults to US. Example: `US`
- `market_code` (string): Bing market, language-country, such as en-us. Example: `es-ar`
- `location` (string): City-level location, such as New York,United States. Example: `<location>`
- `device` (string): Desktop or mobile results. Example: `desktop`
- `page` (number): Results page, from 1. Ads mostly sit on page 1. Example: `5`

Response schema example:
```json
{
  "ads": [
    {
      "position": 0,
      "block_position": "<block_position>",
      "title": "<title>",
      "link": "<link>",
      "displayed_link": "<displayed_link>",
      "tracking_link": "<tracking_link>",
      "snippet": "<snippet>",
      "source": "<source>",
      "sitelinks": {}
    }
  ]
}
```
