Bing Shopping API

The Bing Shopping API retrieves shopping results from Bing with support for market targeting, country localization, pagination, and advanced filters.

Costs 5 API credits per request.

Endpoint: https://api.scrapingdog.com/bing/shopping

API Parameters

🔑

Scrapingdog Parameters

api_key Required
Your personal API key. Available on your dashboard.

Type: String

🔍

Search Query

query Required
Parameter defines the search query. You can enter any term you would normally use in a Bing Shopping search.

Type: String

🌍

Geographic Location

mkt Optional
Parameter defines the market from which the results are returned. The value should be in the <language code>-<country code> format, such as en-US.

In most cases, mkt represents the country where the user is making the request from. However, it can be set to a different country if Bing Shopping API does not return results for the user's actual location.

The value is case-insensitive. For supported values, see Market Codes.

If you know the market, it is recommended to include it. This helps Bing route the request correctly and return better results.

If you pass a market value that is not listed in Market Codes, Bing Shopping API will use the closest matching market based on its internal mapping. This mapping may change over time.

This parameter cannot be used together with the cc query parameter.

Type: String

🌐

Localization

cc Optional
Parameter defines the country from which the search results are returned. It uses the 2-character ISO 3166-1 country code format, such as us for the United States, de for Germany, and gb for the United Kingdom.

Type: String

📄

Pagination

efirst Optional
Parameter controls the offset of the shopping results. For example, efirst=10 starts the results from the 10th shopping result.

Type: String

⚙

️ Advanced Filters

filters Optional
Parameter allows you to apply advanced filters, such as date range filters like ex1:"ez5_18169_18230" or specific display filters like ufn:"Wunderman+Thompson"+sid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513"+catguid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513_cfb02057"+segment:"generic.carousel"+entitysegment:"Organization".

You can create exact filter values by running a Bing search and copying the filters query parameter from the search URL.

Type: String

API Examples

Code to Integrate

curl "https://api.scrapingdog.com/bing/shopping?api_key=APIKEY&query=shoes&cc=us"

import requests

url = "https://api.scrapingdog.com/bing/shopping"
params = {"api_key": "APIKEY", "query": "shoes", "cc": "us"}

response = requests.get(url, params=params)
if response.status_code == 200:
    print(response.json())

const axios = require('axios');

axios.get('https://api.scrapingdog.com/bing/shopping', {
  params: { api_key: 'APIKEY', query: 'shoes', cc: 'us' }
}).then(response => console.log(response.data))
  .catch(error => console.error(error.message));

<?php
$url = 'https://api.scrapingdog.com/bing/shopping/?' . http_build_query([
    'api_key' => 'APIKEY',
    'query'   => 'shoes',
    'cc'      => 'us',
]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);
curl_close($ch);

require 'net/http'
require 'uri'

url = URI.parse("https://api.scrapingdog.com/bing/shopping/")
url.query = URI.encode_www_form('api_key' => 'APIKEY', 'query' => 'shoes', 'cc' => 'us')

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
puts http.request(Net::HTTP::Get.new(url)).body

import java.io.*;
import java.net.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String apiUrl = "https://api.scrapingdog.com/bing/shopping/?api_key=APIKEY&query=shoes&cc=us";
        URL url = new URL(apiUrl);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");
        BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
        String line;
        while ((line = reader.readLine()) != null) System.out.println(line);
        conn.disconnect();
    }
}

API Response

{
  "search_parameters": {
    "q": "shoes"
  },
  "shopping_results": [
    {
      "link": "https://www.bing.com/aclick?ld=e8jXXwsMGS-r11iiiHq2lwtzVUCUwHPenkAhyPsoPwVHfmdMHGcPSjs-nRgTfKlRbGIag9r3VHbqUWl-8jRmtJdcyRuiFtwlqdtv8OOwp46Bu9bi97bn-SEjv59D0oUt1Ag5gD0Qw1ibt0htMSWYYOl4dJcfChd3tY-um5j96RbREPOpPNzrSSCKH5z1QUyf0jCai4zWhK3J7MCF6nVooVLnaZ_Ag&u=aHR0cHMlM2ElMmYlMmZ3d3cuam9lYnJvd25zLmNvLnVrJTJmYmV0c3ktbWFyeS1qYW5lLXNob2VzLWtjNDQ3JTNmX19fc3RvcmUlM2RHQlAlMjZnbENvdW50cnklM2RVSyUyNmdsQ3VycmVuY3klM2RHQlAlMjZtc2Nsa2lkJTNkM2VlZWZlNWI0ZjFhMTY2NjgzMWY5NDFmYTQxNTk3MjclMjZ1dG1fc291cmNlJTNkYmluZyUyNnV0bV9tZWRpdW0lM2RjcGMlMjZ1dG1fY2FtcGFpZ24lM2RQTUFYJTI1MjAlMjU3QyUyNTIwQnJhbmQlMjUyMCUyNTdDJTI1MjBXb21lbnMlMjZ1dG1fdGVybSUzZDIzMjM5NTUyNjYzMDE1MTElMjZ1dG1fY29udGVudCUzZFNTMjYlMjUyMFN1bW1lciUyNTIwU2FsZSUyNTIwUDElMjUyMC0lMjUyMFdvbWVuJTI3cyUyNTIwQnJhbmQlMjNjb2xvdXIlM2QzOTQ&rlid=3eeefe5b4f1a1666831f941fa4159727&ntb=1",
      "external_link": "https://www.joebrowns.co.uk/betsy-mary-jane-shoes-kc447?___store=GBP&glCountry=UK&glCurrency=GBP&msclkid=3eeefe5b4f1a1666831f941fa4159727&utm_source=bing&utm_medium=cpc&utm_campaign=PMAX%20%7C%20Brand%20%7C%20Womens&utm_term=2323955266301511&utm_content=SS26%20Summer%20Sale%20P1%20-%20Women's%20Brand#colour=394",
      "title": "Joe Browns Dark Red Betsy Mary Jane Flat Block Heeled Shoes",
      "thumbnails": [
        "https://th.bing.com/th?id=OPEC.OoOABr%2btEE7wnA474C474&w=180&h=180&c=17&pid=21.1",
        "https://th.bing.com/th/id/OPEC.vE0viFhVbCy5vw474C474?w=240&h=240&c=17&o=5&pid=21.1",
        "https://th.bing.com/th?id=OPEC.sNBwlZeklegr%2bQ474C474&w=240&h=240&c=17&o=5&pid=21.1",
        "https://th.bing.com/th/id/OPEC.6YR2xRCpz9F4Zw474C474?w=240&h=240&c=17&o=5&pid=21.1",
        "https://th.bing.com/th?id=OPEC.b0rZS%2fdRs7MxRA474C474&w=240&h=240&c=17&o=5&pid=21.1"
      ],
      "seller": "Joe Browns",
      "price": "£21.00",
      "extracted_price": 21
    },
    {
      "link": "https://www.bing.com/aclick?ld=e8vdeuEdtLbuJFmxVpo7PwxDVUCUxXX7KyxEF-8U4AfvBWrSKxaD6q1mK7YoBdvQ4uM6aSk6aCUwlBqmVdSSvWGQSTa1FPnzGW9vqME-QohZbbCdDnxTDQHcPH-oU0lyheApxFANbdTIrMmoAjwLR2ZVQWuErFEp7_gnGfW_Zc-py2HY3Oh8CtINtONr0ipSOZO60wm53Fr9FWfMxfP4-LRRfBXVY&u=aHR0cHMlM2ElMmYlMmZjYW1icmlkZ2VrYXlha3MuY28udWslMmZwcm9kdWN0cyUyZnJpbmsta2F5YWtpbmctd2F0ZXItc2hvZSUzZnZhcmlhbnQlM2Q0NzUyNjU1NTI4NzgzMSUyNmNvdW50cnklM2RHQiUyNmN1cnJlbmN5JTNkR0JQJTI2bXNjbGtpZCUzZDNiNGY0MWI1YWFmNzE0NTY5MDk2MmJmMTQxZjhiZDM2JTI2dXRtX3NvdXJjZSUzZGJpbmclMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX2NhbXBhaWduJTNkUE1BWCUyNTIwLSUyNTIwQWxsJTI1MjBQcm9kdWN0cyUyNTIwJTI1NUIxNTAwJTI1MjUlMjUyMFJPQVMlMjU1RCUyNTIwTU0lMjZ1dG1fdGVybSUzZDIzMzU3NzUwMTQ3ODU5NzclMjZ1dG1fY29udGVudCUzZEFsbCUyNTIwQXVkaWVuY2VzJTI1MjBNTQ&rlid=3b4f41b5aaf7145690962bf141f8bd36&ntb=1",
      "external_link": "https://cambridgekayaks.co.uk/products/rink-kayaking-water-shoe?variant=47526555287831&country=GB&currency=GBP&msclkid=3b4f41b5aaf7145690962bf141f8bd36&utm_source=bing&utm_medium=cpc&utm_campaign=PMAX%20-%20All%20Products%20%5B1500%25%20ROAS%5D%20MM&utm_term=2335775014785977&utm_content=All%20Audiences%20MM",
      "title": "Rink Kayaking Water Shoe Grey / 2",
      "thumbnails": [
        "https://th.bing.com/th/id/OPEC.KtfTxNU2RTNGrQ474C474?w=180&h=180&c=17&pid=21.1",
        "https://th.bing.com/th?id=OPEC.ER%2f8ki82tGgBrA474C474&w=240&h=240&c=17&o=5&pid=21.1",
        "https://th.bing.com/th?id=OPEC.rue0THuVTfXK%2bQ474C474&w=240&h=240&c=17&o=5&pid=21.1",
        "https://th.bing.com/th/id/OPEC.ymaLuhDGVrFFXQ474C474?w=240&h=240&c=17&o=5&pid=21.1"
      ],
      "seller": "Cambridge Kayaks",
      "price": "£19.99",
      "extracted_price": 19.99
    }
  ]
}