Bing API endpoint

Search Bing web results

Returns normalized Bing web search results for a query string, including organic results, optional context panel data, related queries, people-also-ask questions, news modules, video modules, and page-based pagination. Empty optional blocks are omitted from the JSON response. Locale defaults to country=us and lang=en-us. Results are fetched with the repo's Chrome-impersonated request client and return 502 when Bing serves a challenge page or unusable HTML.

GETapiKey3 credits/requestbing.searchResponseDoc/bing/search

Parameters

Name	In	Type	Required	Example	Description
q	query	string	Yes	openai	Search query
page	query	integer	No	1	1-based page number; defaults to 1
count	query	integer	No	10	Results per page; defaults to 10, clamped to 1..50
country	query	string	No	us	Two-letter country code; defaults to us
lang	query	string	No	en-us	Bing UI language; defaults to en-us
x-api-key	header	string	Yes		API key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 3 credits/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Failure responses

Status	Description	Schema
400	Missing or invalid query parameters	#/definitions/app.Response
404	No results found	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response
502	Bing upstream request failed	#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "results": [
      {
        "position": 1,
        "title": "OpenAI - Reddit",
        "url": "https://www.reddit.com/r/OpenAI/",
        "description": "OpenAI is an AI research and deployment company. OpenAI's mission is to ensure that artificial general intelligence benefits all of humanity...",
        "hostname": "www.reddit.com",
        "display_url": "https://www.reddit.com › OpenAI",
        "favicon": "https://th.bing.com/th/id/ODLS.A2450BEC-5595-40BA-9F13-D9EC6AB74B9F..."
      }
    ],
    "pagination": {
      "page": 1,
      "count": 10,
      "next_page": 2
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/bing.searchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	bing.SearchResponse	No
data.context	bing.SearchContext	No
data.context.attributes	array	No
data.context.attributes[].label	string	No	Founded
data.context.attributes[].value	string	No	2015
data.context.description	string	No	OpenAI is an AI research and deployment company.
data.context.image	string	No	https://example.com/openai.jpg
data.context.subtitle	string	No	Artificial intelligence research organization
data.context.title	string	No	OpenAI
data.context.url	string	No	https://openai.com/
data.news	array	No
data.news[].age	string	No	2 hours ago
data.news[].age_timestamp	integer	No	1713513600
data.news[].description	string	No	OpenAI announced a new model release.
data.news[].position	integer	No	1
data.news[].source	string	No	Reuters
data.news[].thumbnail	string	No	https://example.com/openai-news.jpg
data.news[].title	string	No	OpenAI announces new model
data.news[].url	string	No	https://example.com/openai-news
data.pagination	bing.SearchPagination	No
data.pagination.count	integer	No	10
data.pagination.next_page	integer	No	2
data.pagination.page	integer	No	1
data.pagination.previous_page	integer	No	1
data.people_also_ask	array	No
data.related_queries	array	No
data.results	array	No
data.results[].age	string	No	Apr 19, 2023
data.results[].age_timestamp	integer	No	1713484800
data.results[].description	string	No	OpenAI is an AI research and deployment company.
data.results[].display_url	string	No	https://www.reddit.com > OpenAI
data.results[].favicon	string	No	https://th.bing.com/th/id/ODLS.example?w=32&h=32
data.results[].hostname	string	No	www.reddit.com
data.results[].position	integer	No	1
data.results[].title	string	No	OpenAI - Reddit
data.results[].url	string	No	https://www.reddit.com/r/OpenAI/
data.videos	array	No
data.videos[].age	string	No	Nov 6, 2023
data.videos[].age_timestamp	integer	No	1699228800
data.videos[].creator	string	No	OpenAI
data.videos[].duration	string	No	45:12
data.videos[].platform	string	No	YouTube
data.videos[].position	integer	No	1
data.videos[].thumbnail	string	No	https://example.com/openai-video.jpg
data.videos[].title	string	No	OpenAI DevDay keynote - YouTube
data.videos[].url	string	No	https://www.youtube.com/watch?v=openai-devday
msg	string	No	OK

Example request

curl -X GET "https://api.crawlora.net/api/v1/bing/search?q=openai&page=1&count=10&country=us&lang=en-us" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/bing/search");
url.searchParams.set("q", "openai");
url.searchParams.set("page", "1");
url.searchParams.set("count", "10");
url.searchParams.set("country", "us");
url.searchParams.set("lang", "en-us");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();

Open in Playground Back to group