Register
Copied to clipboard!

Bing Ad Results API

 / Home / Bing Search API / Ad Results
Code examples
Daily build status

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).

SerpApi JSON structure:
{
  ...,
  "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 Parameters

Name
Required
Description

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
Name
Required
Description

title

Required

Title of the inline sitelink.

tracking_link

Required

Tracking link of the inline sitelink.

sitelinks.extended
Name
Required
Description

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.