Bing Ad Results API

/ Home / Bing Search API / Ad Results

When a Bing search contains advertisements, they are parsed and exist within the ads array in the JSON output. Advertisements can optionally contain thumbnails & site links (inline or extended site links).

Bing Ads example


JSON Example

  {
    ...,
    "ads": [
      {
        "position": 1,
        "block_position": "top",
        "tracking_link": "...",
        "displayed_link": "https://www.ezcater.com/Catering/Menu",
        "sitelinks": {
          "inline": [
            {
              "title": "Enterprise solutions, tracking_link: ..."
            },
            {
              "title": "Our team, tracking_link: ..."
            },
            ...
          ]
        },
        "thumbnail": "data:image/png;base64,...",
        "description": "Place your catering order. Free & easy online ordering. On time delivery."
      }
    ],
    ...
  }

Top-level Ad Fields

position

Required

The position that this ad appears on the page in relation to other ads.

block_position

Required

The location on the page this ad appears in. It will be one of two values: top (before organic results) or bottom (after organic results).

tracking_link

Required

The tracking link.

displayed_link

Required

The displayed link.

description

Required

The description for this advertisement

thumbnail

Optional

A base64 representation of the thumbnail that exists within the advertisement.

sitelinks

Optional

An object containing one of two field values: sitelink.inline, or sitelinks.extended for more descriptive site links.

sitelink.inline

title

Required

Title of the inline sitelink.

tracking_link

Required

Tracking link of the inline sitelink.

sitelinks.extended

title

Required

Title of the expanded sitelink.

tracking_link

Required

Tracking link of the expanded sitelink.

snippet

Required

A short description of this expanded link.