> ## Documentation Index
> Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bing Search ads schema

> Schema for the ads returned by the Bing Search endpoint: text ads and shopping cards, with block position, landing URL, sitelinks, prices and store.

`result.ads` from the [Bing Search endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-bing.md) lists the ads on the Bing results page in page order. Every request returns them, with no `include` flag and no extra credits. The key is omitted when the page has no ads. Each ad has the shape of a [Google Search ad](https://cloro.dev/docs/api-reference/endpoint/google/sponsored-ads.md).

![A sponsored shopping carousel and a text ad with sitelinks in Bing Search](https://mintcdn.com/cloro/MJC-5x6UWjfZumgf/images/bing/search-ads.webp?fit=max\&auto=format\&n=MJC-5x6UWjfZumgf\&q=85\&s=694187f31b65e60aac625a91df04aa7c)

Ads in Bing Search

## Example request

```json theme={null}
{
  "query": "how to remove rust from cast iron",
  "country": "US"
}
```

## Ad types

| Ad | `type` | `blockPosition` |
| - | - | - |
| Text ads above, between and below the results, and small text ads in the side rail | `RESULT` | `top`, `middle`, `bottom`, `rhs` |
| Product cards in the shopping carousel and in ad blocks | `SHOPPING_CARD` | `top`, `middle`, `rhs` |
| Cards in side-rail carousels, such as tours or vehicles for sale | `SHOPPING_CARD`, with `category` | `rhs` |

`position` counts the ads that have the same `blockPosition` and `type`. Sponsored places inside local and hotel lists are not returned.

## Ad structure

Fields of all ads:

| Field | Type | Description |
| - | - | - |
| `position` | number | Position among the ads with the same `blockPosition` and `type` (1-indexed) |
| `blockPosition` | string | `top`, `middle`, `bottom` or `rhs` (side rail) |
| `type` | string | `RESULT` for a text ad, `SHOPPING_CARD` for a card |
| `title` | string | Ad title. On a card, the full product title |
| `url` | string | URL that the ad leads to, decoded from Bing's click-tracking URL. It can be a tracking URL of the advertiser |
| `page` | number | Always `1` |

Fields of `type: RESULT` text ads, each present only when Bing shows it:

| Field | Type | Description |
| - | - | - |
| `displayedUrl` | string | URL as the ad displays it |
| `domain` | string | Domain of the advertiser |
| `description` | string | Ad text, without the "Sponsored" label |
| `rating` | number | Star rating (0–5) |
| `reviews` | string | Review count as the ad shows it, in the language of the page (for example `16 Tsd. Bewertungen`) |
| `sitelinks` | array | Sitelinks under the ad: `url`, `title` and, on a sitelink card, `description` |

Fields of `type: SHOPPING_CARD` cards, each present only when Bing shows it:

| Field | Type | Description |
| - | - | - |
| `price` | object | Price, with the [Google ad price shape](https://cloro.dev/docs/api-reference/endpoint/google/sponsored-ads.md#price-shape) |
| `oldPrice` | object | Price before the discount, same shape as `price` |
| `store` | string | Merchant or dealer |
| `category` | string | Label of a side-rail carousel (for example `Vehicles for sale`). Not on the shopping carousel |

Bing ads have no `imageUrl`, and cards have no `description`, `rating` or `reviews`.

## Response example

The example request returns three text ads below the results and nine product cards in the side rail. Two of them are shown here, with shortened URLs.

```json theme={null}
{
  "success": true,
  "result": {
    "ads": [
      {
        "position": 2,
        "blockPosition": "bottom",
        "title": "Remove Rust Cast Iron Cookware with RustAid 32 oz",
        "url": "https://www.homedepot.com/p/RustAid-32-oz-Rust-Remover-Spray-for-Removing-Rust-on-Iron-and-Steel-Surfaces-1-Pack-ERAR310/334465308?mtc=…",
        "page": 1,
        "type": "RESULT",
        "displayedUrl": "https://www.homedepot.com › SolventsRemover › andCleaners",
        "domain": "homedepot.com",
        "description": "Shop Our Wide Selection of Rustaid® Products for All Your Home Improvement Needs."
      },
      {
        "position": 5,
        "blockPosition": "rhs",
        "title": "Culina Cast Iron Scrub - Rust Removal & Seasoning Cleaner For Cast Iron Cookware, Removes Burnt Food - 100% Natural Coconut Oil, Non-Scratch Cleaning",
        "url": "https://www.amazon.com/Culina-Cast-Iron-Scrub-Non-Scratch/dp/B08BTVXLXN/ref=asc_df_B08BTVXLXN?tag=…",
        "page": 1,
        "type": "SHOPPING_CARD",
        "price": { "value": 12.57, "currency": "$", "raw": "$12.57" },
        "oldPrice": { "value": 16.99, "currency": "$", "raw": "$16.99" },
        "store": "Amazon.com"
      }
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.