Bing Search International

Perform Search

POST /api/v1/open/bing/search

Request Example

bash

curl -X POST "https://domain/api/v1/open/bing/search" \
  -H "Content-Type: application/json" \
  -d '{
  "q": "coffee",
  "engine": "bing",
  "api_key": "your_api_key_here"
}'

Request Parameters

Parameter	Type	Required	Description	Default
api_key	string	Yes	API key for authentication
engine	string	No	Search engine type	bing
q	string	Yes	Parameter defines the search query. You can use anything that you would use in a regular Bing search. (e.g., 'query', NOT, OR, site:, filetype:, near:, ip:, loc:, feed: etc.).
cc	string	No	Parameter defines the country to search from. It follows the 2-character ISO_3166-1 format. (e.g., us for United States, de for Germany, gb for United Kingdom, etc.).
date	string	No	Time range filter: d-last day, w-last week, m-last month, y-last year
filters	string	No	Parameter allows usage of a more complex filtering options such as filtering by date range ex1:"ez5_18169_18230" or using a specific display filters such as ufn:"Wunderman+Thompson"+sid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513"+catguid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513_cfb02057"+segment:"generic.carousel"+entitysegment:"Organization". Exact values can be constructed by using Bing search and copying filters query parameter.
mkt	string	No	The market where the results come from (e.g. en-US). Typically, mkt is the country where the user is making the request from. However, it could be a different country if the user is not located in a country where Bing delivers results. The market must be in the form <language code>-<country code>. For example, en-US. The string is case insensitive. For a list of possible market values, see Market Codes. NOTE: If known, you are encouraged to always specify the market. Specifying the market helps Bing route the request and return an appropriate and optimal response. If you specify a market that is not listed in Market Codes, Bing uses a best fit market code based on an internal mapping that is subject to change. This parameter and the cc query parameter are mutually exclusive—do not specify both.
first	number	No	Parameter controls the offset of the organic results. This parameter defaults to 1. (e.g., first=10 will move the 10th organic result to the first position).
count	number	No	Parameter controls the number of results per page. Minimum: 1, Maximum: 50. This parameter is only a suggestion and might not reflect actual results returned.
safeSearch	string	No	Parameter defines the level of filtering for adult content. It can be set to: Off to return webpages with adult text, images, or videos. Moderate to return webpages with adult text, but not adult images or videos. Strict to not return webpages with adult text, images, or videos.
html	string	No	Whether to return HTML format, 1-yes, 0-no	0

Response Example

{
    "code": 200,
    "data": {
        "search_metadata": {
          "bing_url": "https://www.bing.com/search?q=coffee&first=1&device=desktop",
          "created_at": "2025-11-11 17:16:14",
          "id": "a3c6ebd0b5374eaabc6f7d625b8172a8",
          "json_endpoint": null,
          "processed_at": "2025-11-11 09:16:14 UTC",
          "raw_html_file": null,
          "status": "Success",
          "total_time_taken": 0.33284
        },
        "search_information": {
          "detected_location": "coffee",
          "page": 1,
          "total_results": "8050000"
        },
        "search_parameters": {
          "device": "desktop",
          "engine": "bing",
          "first": 1,
          "q": "coffee"
        },
        "organic_results": [
            {
                "displayed_link": "https://www.amazon.com › coffee",
                "link": "https://www.bing.com/ck/a?!&&p=3752b5051a33c22ac370433b480a8b5bbc9fa0cc27bb301b6beea5899255533bJmltdHM9MTc2MTAwNDgwMA&ptn=3&ver=2&hsh=4&fclid=28a1f70f-3c5b-6014-183a-e1833d3961bf&psq=coffee&u=a1aHR0cHM6Ly93d3cuYW1hem9uLmNvbS9jb2ZmZWUvcz9rPWNvZmZlZQ&ntb=1",
                "position": 1,
                "snippet": "Nestle Coffee mate Coffee Creamer, French Vanilla, Liquid Creamer Singles, Non Dairy, No Refrigeration, 0.375 fl oz Tubs (Pack of 180) French Vanilla 20K+ bought in past month Extra ...",
                "source": "Amazon",
                "thumbnail": "https://th.bing.com/th/id/ODF.QhaTy7HPvKoaJWwye8j2CQ?w=32&h=32&qlt=91&pcl=ffffffa&o=6&cb=12&pid=1.2",
                "title": "Amazon.com: Coffee",
                "date": "6 days ago"
            }
        ],
        "copilot_search": {
            "snippet": "Origins and History Discovery: Coffee is believed to have originated in Ethiopia,",
            "thumbnail": "https://thvnext.bing.com/th/id/OIP.olhDe90Be2Tj0FpAOVyH9wHaEM?w=200&h=200&c=10&o=6&cb=12&pid=genserp&rm=2&ucfimg=1",
            "title": "Coffee is a globally cherished beverage made from roasted coffee beans, originating from the Coffea plant, with a rich history and cultural significance."
        },
        "shopping_ads": [
          {
              "block_position": [
                  "top"
              ],
              "extracted_price": "7.03",
              "image": "https://thvnext.bing.com/th/id/OPHS.mnbosHEKms3ZSA474C474?w=128&h=188&o=5&cb=12&bw=6&bc=ffffff&pid=21.1&ucfimg=1",
              "link": "https://www.bing.com/aclk?ld=e808CYq3CzZdqO7RfCE rZQOjVUCUysVUhYRAe47LaT75yVJbdDtyvEuscke5hVAZZlscUuZ8kJfu0FD",
              "position": 5,
              "price": "$7.03",
              "rating": "4",
              "reviews": "1K+",
              "reviews_link": "https://www.bing.com/ck/a?!&&p=4ec54566ae98dd9b6a34a5cba34cdfa042a1dfcd9e2216e0f2227c55a69ac569JmltdHM9MTc2MTA5MTlwMA&ptn=3&ver=2&hsh=4&fclid=2f6",
              "seller": "Walmart",
              "title": "Folgers Classic Roast Ground Coffee, Medium Roast, 9.6 Oz Canister"
          }
      ],
      "ads": [
          {
              "block_position": "bottom",
              "displayed_link": "https://www.goldstarcoffee.com",
              "link": "https://www.bing.com/aclk?ld=e8iamjs2_9hORSrATKCwbPsjVUCUx1D8QyWRoDrett18yPgnavtps5i7Y7M-l9hx5eB-V3nmoTkhgyt3auMaLiyqeUCXnVzli45ZNN7Ob438r7nlUIKLU6x1XCnPEt6cUQ4K2R1H1ZteJyvWGqqd_OIMB16BmPY28zUQw6Pdu72wQJCd1mXrilLM305PwO9u12wGJtAw&u=aHR0cCUzYSUyZiUyZnd3dy5nb2xkc3RhcmNvZmZlZS5jb20lM2Ztc2Nsa2lkJTNkNGJkMjcwMmUzOThhMTJkN2QxN2ExOGQ2YjNkNjQ1OTE&rlid=4bd2702e398a12d7d17a18d6b3d64591&ntb=1",
              "position": 1,
              "snippet": "Sponsored Blue Mountain, Kona *Use 5% off Coupon Code: BING. Experience The Benefits Of Premium Coffee In The Comfort Of Your Own Home!",
              "source": "goldstarcoffee.com",
              "title": "The Best Tasting Coffee | Order The Best Coffee Today",
              "tracking_link": "https://www.bing.com/aclk?ld=e8iamjs2_9hORSrATKCwbPsjVUCUx1D8QyWRoDrett18yPgnavtps5i7Y7M-l9hx5eB-V3nmoTkhgyt3auMaLiyqeUCXnVzli45ZNN7Ob438r7nlUIKLU6x1XCnPEt6cUQ4K2R1H1ZteJyvWGqqd_OIMB16BmPY28zUQw6Pdu72wQJCd1mXrilLM305PwO9u12wGJtAw&u=aHR0cCUzYSUyZiUyZnd3dy5nb2xkc3RhcmNvZmZlZS5jb20lM2Ztc2Nsa2lkJTNkNGJkMjcwMmUzOThhMTJkN2QxN2ExOGQ2YjNkNjQ1OTE&rlid=4bd2702e398a12d7d17a18d6b3d64591&ntb=1"
          }
      ],
      "local_map": {
          "image": "https://www.bing.com/maps/geoplat/REST/v1/Imagery/Map/RoadVibrant/37.663628,-97.570183/15?ms=648,200&sv=9.42&ml=Basemap,LandCover,Landmarks&key=AnTcaqBi2ypp0xl-",
          "link": "https://www.bing.com/ck/a?!&&p=faf6858ddb440384cbb5c4be96d9c7159b5cec29e6ed2505eeace3ca34f65fe4JmltdHM9MTc2MTA5MTlwMA&ptn=3&ver=2&hsh=4&fclid=1df28638-9d3a-"
      },
      "local_results": [
          {
              "address": "117 N Main St, Cheney",
              "gps_coordinates": {
                  "latitude": 37.62751770019531,
                  "longitude": -97.7812728881836
              },
              "id": "YN58A95DD190F39920",
              "is_closed": true,
              "is_copilot_answer": true,
              "link": "https://www.bing.com/ck/a?!&&p=9ce174992e481bd4bebc262ec9b19cc348d9b2ecffb1d5e1251c968f806a58d4JmltdHM9MTc2MTAwNDgwMA&ptn=3&ver=2&hsh=4&fclid=28a1f70f-",
              "open_hours": "Closed · Opens tomorrow 7 AM",
              "phone": "(316) 312-2735",
              "position": 1,
              "title": "Willowleaf Bakery & Coffee Bar",
              "website": "https://www.bing.com/ck/a?!&&p=45476021b1e45e5a976fc6123130237fe542399fae8b7e74947596b6f2db6910JmltdHM9MTc2MTAwNDgwMA&ptn=3&ver=2&hsh=4&fclid=28a1f70f"
          }
      ],
      "top_stories": [
        { 
          "date": " 3h", 
          "link": "https://www.bbc.com/zhongwen/articles/cx2prjw1x11o/simp",
          "position": 5,
          "snippet": "…",
          "source": "BBC",
          "title": ""
        }
      ],
      "related_searches": [
          {
              "link": "https://www.bing.com/ck/a?!&&p=17b564877c57977522e6b3f5df5118ea18e4663674e888a1f844dd55383a8000JmltdHM9MTc2MTAwNDgwMA&ptn=3&ver=2&hsh=4&fclid=28a1f70f-3c5b-6014-183a-e1833d3961bf&u=a1L3NlYXJjaD9xPXBlcmNlbnQrY29mZmVlJkZPUk09UVNSRTE&ntb=1",
              "query": "percent coffee"
          }
      ],
      "suggested_searches": [
          {
              "link": "https://www.bing.com/ck/a?!&&p=a681abbe6636240eb03a3fed3c73eb0813fcf22e7ede189d4e12003751cc8c52JmltdHM9MTc2MTAwNDgwMA&ptn=3&ver=2&hsh=4&fclid=28a1f70f-3c5b-6014-183a-e1833d3961bf&u=a1L2ltYWdlcy9zZWVyY2g_cT1Db2ZmZWUrTXVncyZGT1JNPUlBUIJNMSw&ntb=1",
              "name": "Coffee Mugs",
              "thumbnail": "https://th.bing.com/th?q=Coffee+Mugs&w=30&h=30&c=7&rs=1&p=0&o=5&cb=12&pid=1.7&mkt=en-US&cc=US&setlang=en&adlt=moderate&t=1"
          }
      ],
      "images_results": [
          {
              "link": "https://www.bing.com/ck/a?!&&p=4d701538cc9c44000d5274fb199b215bb2e57bf423b270d7959754835ac9b4abJmltdHM9MTc2MTAwNDgwMA&ptn=3&ver=2&hsh=4&fclid=28a1f70f-3c5b-6014-183a-e1833d3961bf&u=a1L2ltYWdlcy9zZWVyY2g_cTljb2ZmZWUmaWQ9Q0RCMTlfOUNBOTZFNjkxQzhCMURFMkZGRTg5NTk4QzQ5RjYwRkVERiZGT1JNPUlRRUJCQQ&ntb=1",
              "original": "https://www.bing.com/th/id/OIP.uM0VZpivlfDNUgz57RBvzAHaLH?w=122&h=128&c=8&rs=1&qlt=90&o=6&cb=12&pid=3.1&rm=2",
              "original_height": "128",
              "original_width": "122",
              "position": 1,
              "title": "Coffee Free Images | Everypixel"
          }
      ],
      "videos": [
          {
              "channel": "Good Mythical Morning",
              "date": "23 hours ago",
              "duration": "23:06",
              "is_adult": "False",
              "link": "https://www.youtube.com/watch?v=k5Yvhn8OI3M",
              "position": 1,
              "source": "YouTube",
              "title": "International Coffee Taste Test",
              "views": "538.2K views"
          }
      ],
      "pagination": {
          "current": "1",
          "next": "https://www.bing.com/search?q=coffee&cc=US&first=11&device=desktop",
          "other_pages": {
              "2": "https://www.bing.com/search?q=coffee&cc=US&first=11&device=desktop",
              "3": "https://www.bing.com/search?q=coffee&cc=US&first=21&device=desktop",
              "4": "https://www.bing.com/search?q=coffee&cc=US&first=31&device=desktop"
          }
      }
    },
    "msg": "string",
    "reqId": "string"
}

search_metadata

object Contains metadata about the search execution

Parameter	Type	Description	Applicable Terminal
id	string	Unique identifier for the search request
status	string	Status of the search execution (e.g., Success)
json_endpoint	string	Provide an interface endpoint for searching related JSON data, through which JSON-formatted search data can be obtained
created_at	string	The timestamp when the search request was created, recording the time when the search was initiated
processed_at	string	The timestamp when the search results were processed and became available for return, recording the time point from processing to completion of the search
bing_url	string	Request URL for Bing Search, containing parameters such as search keyword (coffee), region (US), pagination (first=1), and device type (desktop), used to navigate to the corresponding Bing search page
raw_html_file	string	Identifier for the original HTML file
total_time_taken	number	The total time spent on the entire search process (including request sending, result parsing, and other stages)

search_information

object Contains information about the search results

Parameter	Type	Description	Applicable Terminal
organic_results_state	string	State of organic results
page_number	number	Current page number (indicating the current pagination index of the search results, used for browsing search results by pages)
time_taken_displayed	number	TDisplay time (i.e., the time spent on displaying the search results)
total_results	string	Total results count (the total number of results returned by this search)

search_parameters

object Contains the parameters used for the search

Parameter	Type	Description	Applicable Terminal
q	string	Keywords used for this query
engine	string	Search engine used for this query (e.g., bing)
cc	string	Used to specify the country or region scope of search results
html	string	When HTML=0, returns JSON; when HTML=1, returns HTML; when HTML=2, returns both JSON and HTML

organic_results

object[] Organic search results from Bing, excluding ads and special result types, containing title, URL, summary, and source information

Parameter	Type	Description	Applicable Terminal
position	number	Position/rank of the search result (identifying the order of the result in the list)
title	string	Title of the entry (a name summarizing the core content, such as a webpage title)
link	string	Target URL of the result (the original link that users are redirected to upon clicking)
source	string	Source of the content (such as website name, media platform, or other origin identifiers)
source_logo	string	Logo URL of the source (image address of the brand identifier, typically in data:image/png;base64 format)
displayed_link	string	Display URL (a simplified and formatted version of the link for user-friendly presentation on the page)
snippet	string	Content summary (a brief description of the core information)
thumbnail	string	Thumbnail URL of the result (used to display small images in search results for enhanced visual context)
date	string	Content date (publication date or update date, typically in "YYYY-MM-DD" format)

copilot_search

object Data related to Bing Copilot (AI-assisted search features), such as AI-generated suggestions, summaries, or creative content

Parameter	Type	Description	Applicable Terminal
title	string	Topic title, providing a definitional summary of the search subject
snippet	string	Information summary, providing a concise explanation of key knowledge points related to the search topic
thumbnail	string	Thumbnail URL for supporting topic comprehension, used to provide visual information supplements

shopping_ads

object[] Bing shopping ads that display e-commerce product information such as name, price, seller, and image

Parameter	Type	Description	Applicable Terminal
title	string	Product title, summarizing the core information of the item
seller	string	Seller name of the product
link	string	Product redirect URL, leading to the purchase or detail page of the item
price	string	Product listed price (including currency symbol)
extracted_price	string	Extracted product price value
rating	string	User rating of the product
reviews	string	Number of product reviews
reviews_link	string	Redirect URL to the product review page, where detailed user evaluations can be viewed
image	string	Direct URL of the product image, used to display the product's appearance
position	number	Ranking of the product ad in the shopping ads list
block_position	string[]	Position of the ad block on the page

ads

object[] Bing shopping ads that display e-commerce product information such as name, price, seller, and image

Parameter	Type	Description	Applicable Terminal
title	string	Ad title
source	string	Source domain of the advertisement
link	string	Source URL of the advertisement
tracking_link	string	Tracking URL of the advertisement, used to monitor ad clicks
displayed_link	string	Displayed domain link of the ad, representing the advertiser's brand domain
snippet	string	Ad summary, describing the user's promotion or selling points
position	number	Ranking of the ad within the ad list
block_position	string	Position of the ad block on the page

local_map

object Bing local map results, displaying location-based map-related content

Parameter	Type	Description	Applicable Terminal
image	string	Redirect URL to the local map location
link	string	Resource URL of the map image displayed in the local map module

local_results

object[] Bing local results, including geographically relevant content such as local businesses and lifestyle services (e.g., restaurants, shops)

Parameter	Type	Description	Applicable Terminal
address	string	Business's physical address, used to locate offline stores
gps_coordinates	object	Latitude and longitude coordinates of the business, used for map positioning or distance calculation
gps_coordinates.latitude	number	Latitude value, precisely indicating the north-south position of the business
gps_coordinates.longitude	number	Longitude value, precisely indicating the east-west position of the business
id	string	Unique identifier of the business in the Bing system, used to distinguish different local merchants
is_closed	boolean	Whether the business is currently closed; true indicates "closed"
is_copilot_answer	boolean	Whether the response is generated by Bing Copilot (AI-assisted feature); true indicates "yes"
link	string	Redirect link to the business information page, leading to Bing's local result details
open_hours	string	Business hours, indicating whether the merchant is currently open and showing operating times
position	number	Ranking of the business in local results
phone	string	Business contact number, enabling users to inquire or make offline appointments
title	string	Name of the merchant or store
website	string	Redirect link to the business's official website, allowing access to its online platform

top_stories

object[] Bing trending news / information section, displaying time-sensitive news links, headlines, and publication times

Parameter	Type	Description	Applicable Terminal
date	string	Content date (publication date or update date, typically in "YYYY-MM-DD" format)
link	string	Redirect link to the news article
position	number	Ranking of the news item within the trending news module
source	string	Source platform of the news
title	string	News title
snippet	string	Content summary (a brief description of the core information)

related_searches

object[] Bing related searches, displaying other search terms relevant to the current query (typically shown at the bottom of the results page)

Parameter	Type	Description	Applicable Terminal
query	string	Related search terms recommended by Bing
link	string	Redirect link for the related search term

suggested_searches

object[] Bing search suggestions, which are related and expanded keywords recommended after the user enters a query

Parameter	Type	Description	Applicable Terminal
link	string	Redirect link for the suggested search term
name	string	Specific search suggestion terms recommended by Bing
thumbnail	string	Thumbnail URL for the suggested search term, used to display a small preview image in the suggestion list

images_results

object[] Bing image search results, including image URLs, source webpages, image dimensions, and thumbnails

Parameter	Type	Description	Applicable Terminal
link	string	Redirect link for the image
original	string	Direct URL of the original image
original_height	string	Height of the original image
original_width	string	Width of the original image
position	number	Ranking of the image within the image search results
title	string	Title of the image, typically describing its content or source

videos

object[] Bing video search results, including video title, URL, source platform (e.g., YouTube, Bing Videos), duration, and publish time

Parameter	Type	Description	Applicable Terminal
channel	string	Name of the channel that published the video
date	string	Publish time of the video
duration	string	Duration of the video
is_adult	string	Whether the video contains adult content; "False" means "No", used to filter inappropriate material
link	string	Redirect link to the video playback page
position	number	Ranking of the video within the video search results
source	string	Source platform of the video
title	string	Video title
views	string	View count of the video

pagination

object Pagination information of Bing search results, including current page number, total pages, next/previous page links, and navigation logic

Parameter	Type	Description	Applicable Terminal
current	string	Current page number
next	string	Next page navigation link (can directly jump to the next page of search results)
other_pages	object	An object containing navigation links to other pages (such as page 2, page 3, etc.)