Bing Search International

Perform Search

POST /api/v1/open/bing/search

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.).
`device`	`string`	No	Device type, currently only supports desktop version	desktop
`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	desktop
`status`	`string`	Status of the search execution (e.g., Success)	desktop
`json_endpoint`	`string`	Provide an interface endpoint for searching related JSON data, through which JSON-formatted search data can be obtained	desktop
`created_at`	`string`	The timestamp when the search request was created, recording the time when the search was initiated	desktop
`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	desktop
`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	desktop
`raw_html_file`	`string`	Identifier for the original HTML file	desktop
`total_time_taken`	`number`	The total time spent on the entire search process (including request sending, result parsing, and other stages)	desktop

search_information

object Contains information about the search results

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

search_parameters

object Contains the parameters used for the search

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

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

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	desktop
`snippet`	`string`	Information summary, providing a concise explanation of key knowledge points related to the search topic	desktop
`thumbnail`	`string`	Thumbnail URL for supporting topic comprehension, used to provide visual information supplements	desktop

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	desktop
`seller`	`string`	Seller name of the product	desktop
`link`	`string`	Product redirect URL, leading to the purchase or detail page of the item	desktop
`price`	`string`	Product listed price (including currency symbol)	desktop
`extracted_price`	`string`	Extracted product price value	desktop
`rating`	`string`	User rating of the product	desktop
`reviews`	`string`	Number of product reviews	desktop
`reviews_link`	`string`	Redirect URL to the product review page, where detailed user evaluations can be viewed	desktop
`image`	`string`	Direct URL of the product image, used to display the product's appearance	desktop
`position`	`number`	Ranking of the product ad in the shopping ads list	desktop
`block_position`	`string[]`	Position of the ad block on the page	desktop

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	desktop
`source`	`string`	Source domain of the advertisement	desktop
`link`	`string`	Source URL of the advertisement	desktop
`tracking_link`	`string`	Tracking URL of the advertisement, used to monitor ad clicks	desktop
`displayed_link`	`string`	Displayed domain link of the ad, representing the advertiser's brand domain	desktop
`snippet`	`string`	Ad summary, describing the user's promotion or selling points	desktop
`position`	`number`	Ranking of the ad within the ad list	desktop
`block_position`	`string`	Position of the ad block on the page	desktop

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	desktop
`link`	`string`	Resource URL of the map image displayed in the local map module	desktop

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

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)	desktop
`link`	`string`	Redirect link to the news article	desktop
`position`	`number`	Ranking of the news item within the trending news module	desktop
`source`	`string`	Source platform of the news	desktop
`title`	`string`	News title	desktop
`snippet`	`string`	Content summary (a brief description of the core information)	desktop

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	desktop
`link`	`string`	Redirect link for the related search term	desktop

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	desktop
`name`	`string`	Specific search suggestion terms recommended by Bing	desktop
`thumbnail`	`string`	Thumbnail URL for the suggested search term, used to display a small preview image in the suggestion list	desktop

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	desktop
`original`	`string`	Direct URL of the original image	desktop
`original_height`	`string`	Height of the original image	desktop
`original_width`	`string`	Width of the original image	desktop
`position`	`number`	Ranking of the image within the image search results	desktop
`title`	`string`	Title of the image, typically describing its content or source	desktop

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	desktop
`date`	`string`	Publish time of the video	desktop
`duration`	`string`	Duration of the video	desktop
`is_adult`	`string`	Whether the video contains adult content; "False" means "No", used to filter inappropriate material	desktop
`link`	`string`	Redirect link to the video playback page	desktop
`position`	`number`	Ranking of the video within the video search results	desktop
`source`	`string`	Source platform of the video	desktop
`title`	`string`	Video title	desktop
`views`	`string`	View count of the video	desktop

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	desktop
`next`	`string`	Next page navigation link (can directly jump to the next page of search results)	desktop
`other_pages`	`object`	An object containing navigation links to other pages (such as page 2, page 3, etc.)	desktop