Skip to main content

Bing Search API

Written by Kadri - RichAPI Support Team

POST /search_bing • Credits: 1 credit per call

Bing Search runs one web search on Bing and returns the ranked results as JSON. The response holds a data.results array with the title, destination URL, description and rank position of each result. Each call costs 1 credit, whatever the number of results in the response.

What does Bing Search do?

Bing Search answers the question "which pages does Bing return for this query?" in one HTTP call. The endpoint reads the public Bing result page for the query text and parses each organic result. It returns the destination URL of each result, not the Bing tracking link. Bing Search accepts the standard Bing operators, such as site:, intitle: and a quoted phrase. Bing Search needs no Bing account, no Azure subscription and no search contract. One RichAPI key covers the whole flow.

Which endpoint does Bing Search use?

  • Method: POST

  • URL: https://api.richapi.ai/api/v1/search_bing

  • Authentication: x-api-key header

  • Response: synchronous JSON

  • Credits: 1 credit per call

  • Results per call: 1 to 50

How to send a Bing Search request

  1. Copy your API key from the RichAPI dashboard.

  2. Set the query parameter to the search text.

  3. Set the limit parameter to a number between 1 and 50.

  4. Set the page parameter to 1 for the first page of results.

  5. Send a POST request to https://api.richapi.ai/api/v1/search_bing.

  6. Send the API key in the x-api-key header.

  7. Read the data.results array from the response.

CAUTION: Each Bing Search call costs 1 credit. A query with no match also costs 1 credit.

cURL

curl -X POST https://api.richapi.ai/api/v1/search_bing   
-H "x-api-key: YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
"query": "figma design tool",
"limit": 10,
"page": 1
}'

Python

import requests

response = requests.post(
"https://api.richapi.ai/api/v1/search_bing",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"query": "figma design tool",
"limit": 10,
"page": 1,
},
timeout=60,
)
response.raise_for_status()
results = response.json()["data"]["results"]
for item in results:
print(item["position"], item["url"], item["title"])

Node.js

const response = await fetch("https://api.richapi.ai/api/v1/search_bing", {
method: "POST",
headers: {
"x-api-key": "YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "figma design tool",
limit: 10,
page: 1,
}),
});

const data = await response.json();
console.log(data.data.results.map((item) => item.url));

Which parameters does Bing Search accept?

Parameter

Type

Required

Default

Description

query

string

Yes

None

The search text. The value accepts the Bing operators, such as site:example.com or a quoted phrase.

limit

integer

Yes

0

The number of results on one page. The accepted range is 1 to 50.

page

integer

No

0

The result page to read. The accepted range is 1 to 20.

Bing Search accepts these three fields and rejects every other field. An unknown field returns a 400 error that names the field and lists the supported fields.

CAUTION: Set limit and page in every request. The stored default of both parameters is 0, and the search service rejects 0 with a 422 error.

Which name does the Bing Search request body use for the result count?

Bing Search accepts the result count under the name limit. A request body that holds num_results returns a 400 error. Send limit.

The RichAPI dashboard, the automation editor, the n8n node and the MCP tool take the same three names as the request body.

How do limit and page select the result set?

Bing Search reads one page of Bing results per call. The limit parameter sets the size of that page. The page parameter selects which page the endpoint reads. The first Bing result of a page is 1 + (page - 1) * limit. The position field restarts at 1 in every response, so the rank is relative to the page.

limit

page

First Bing result

Credits

10

1

1

1

10

2

11

1

25

3

51

1

50

1

1

1

The credit count is 1 in every row of the table. A deep page costs the same as the first page.

What does Bing Search return?

The block below is an example response for the query figma design tool with limit set to 10. The field names and the structure are exact. The titles, the URLs, the descriptions and the timings are illustrative. The example shows 3 of the 10 results.

{
"data": {
"results": [
{
"title": "Figma: The Collaborative Interface Design Tool",
"url": "https://www.figma.com/",
"description": "Figma is a design tool that runs in the browser. Teams edit one file together and hand off specs to developers.",
"position": 1,
"displayed_url": "https://www.figma.com",
"date_published": null,
"thumbnail": null
},
{
"title": "Figma vs Sketch: Which Design Tool Fits Your Team?",
"url": "https://www.uxdesigninstitute.com/blog/figma-vs-sketch/",
"description": "Mar 4, 2026 · A side by side comparison of Figma and Sketch on price, platform support and collaboration.",
"position": 2,
"displayed_url": "https://www.uxdesigninstitute.com/blog/figma-vs-sketch",
"date_published": "Mar 4, 2026",
"thumbnail": "https://th.bing.com/th/id/OIP.9tQdesign1"
},
{
"title": "Figma Pricing Plans",
"url": "https://www.figma.com/pricing/",
"description": "Compare the Starter, Professional and Organization plans of Figma, with the seat price of each plan.",
"position": 3,
"displayed_url": "https://www.figma.com/pricing",
"date_published": null,
"thumbnail": null
}
],
"total_results": 10,
"query": "figma design tool",
"related_searches": [
"figma pricing",
"figma vs sketch",
"figma tutorial for beginners"
]
},
"meta": {
"cache_hit": false,
"execution_time_ms": 1428,
"quality_warning": null
}
}

Which fields does the Bing Search response hold?

Field

Type

Description

data

object

The result of the search.

data.results

array of objects

The organic results of one Bing page, in rank order.

data.results[].title

string

The title text of the result.

data.results[].url

string

The destination URL of the result. Bing Search resolves the Bing tracking link to the real URL.

data.results[].description

string

The snippet text under the title. The value is an empty string for a result with no snippet.

data.results[].position

integer

The rank of the result inside this response. The count starts at 1.

data.results[].displayed_url

string or null

The URL text that Bing shows under the title.

data.results[].date_published

string or null

The date that Bing shows for the result. The value is null for a result with no date.

data.results[].thumbnail

string or null

The URL of the thumbnail image of the result. The value is null for a result with no image.

data.total_results

integer

The number of results in this response. The value is not the total match count of Bing.

data.query

string

The query text that ran.

data.related_searches

array of strings

The related queries that Bing shows at the foot of the result page.

meta

object

The metadata of the call.

meta.cache_hit

boolean

The value is true for a result served from the cache.

meta.execution_time_ms

integer

The duration of the call, in milliseconds.

meta.quality_warning

string or null

The value is null. Bing Search sets no quality warning.

How does the Bing Search cache work?

Bing Search reads a shared result cache on every call. The request body holds no cache parameter, and the cache is on for every request. The cache key is the query value, the result count and the page number. A stored result stays valid for 1 hour. The meta.cache_hit field reports the source of each response. A cached call costs 1 credit, the same as a live call. For a fresh result inside the hour, change the query text or the limit value, because a new key misses the cache.

How do you find the official website of a company with Bing Search?

A company list often holds a name and no domain. Bing Search turns the name into a ranked URL list, and the top organic result is the company site in most cases.

  1. Build the query value from the company name and one word from its market.

  2. Set limit to 10 and page to 1.

  3. Send the Bing Search request.

  4. Read the url field of each result in rank order.

  5. Drop the results on the directory hosts, such as linkedin.com and crunchbase.com.

  6. Take the first remaining URL as the company site.

  7. Send that URL to the Website Intelligence endpoint for the company record.

One lookup costs 1 credit, or $0.02. A list of 500 companies costs 500 credits, or $10.00.

How do you find recent news about a company with Bing Search?

A news monitor needs no news contract and no press feed. Bing Search returns the same articles that a Bing visitor sees, and the date_published field carries the date that Bing shows.

  1. Build the query value from the company name and a news word, such as funding or acquisition.

  2. Set limit to 25 and page to 1.

  3. Send one request per company, once per day.

  4. Read the url and the date_published value of each result.

  5. Compare the url values against the run of the day before.

  6. Report a new url as a new article.

A daily news check over 50 companies costs 50 credits per day, or $1.00. That is 1,500 credits per month, or $30.00.

CAUTION: Bing Search caches a result for 1 hour. A repeat of the same query, limit and page inside that hour returns the stored result and still costs 1 credit.

How much does Bing Search cost?

Bing Search costs 1 credit per call. 1 credit costs $0.02 on the 1,000 and 5,000 credit packs. Larger packs cost less per credit. The credit count does not change with the number of results. A call that returns 50 results and a call that returns none both cost 1 credit.

Calls

Credits

Cost

1

1

$0.02

100

100

$2.00

1,000

1,000

$20.00

10,000

10,000

$200.00

How does the price of Bing Search compare with the Google Search Scraper?

Bing Search bills 1 credit per call. The Google Search Scraper endpoint bills 0.2 credits per organic result in its response. At 5 results the two cost the same.

Endpoint

Billing unit

Credits for 10 results

Cost

Bing Search, /search_bing

1 credit per call

1

$0.02

Google Search Scraper, /google_search_scraper_sync

0.2 credits per organic result

2

$0.04

The difference grows with depth. One Bing Search call returns up to 50 links for 1 credit, and the Google Search Scraper bills each organic result that it returns. At 1,000 searches of 10 results each, Bing Search costs 1,000 credits, or $20.00, and the Google Search Scraper costs 2,000 credits, or $40.00.

Which errors can Bing Search return?

Status

Meaning

What to do

400

The request body failed validation.

Correct the parameter that the message names. Send limit and not num_results.

401

The API key is missing, wrong or revoked.

Send a valid key in the x-api-key header.

402

Insufficient credits: the organization has too few credits. Or Monthly spend limit reached: the team hit its monthly spend limit.

Buy credits in the RichAPI dashboard, or ask the organization owner to raise the spend limit.

403

Endpoint not available on your plan: this API key has no access to this endpoint.

Call GET /api/v1/my-endpoints to list the endpoints this key can use. Contact support for access.

404

The endpoint name is wrong.

Send the request to /search_bing.

422

The search service rejected a parameter value.

Set limit between 1 and 50. Set page between 1 and 20.

429

Too many requests.

Read the Retry-After header. Wait that many seconds, then send the request again.

500

The API failed.

Send the request again. If the failure repeats, contact support.

502

Bing did not answer.

Wait a few seconds, then send the request again.

RichAPI charges no credit for a 400, 401, 402, 403, 404, 422, 429, 500 or 502 response.

Frequently asked questions

How many results does one Bing Search call return?

One Bing Search call returns between 1 and 50 results, under the control of the limit parameter. A narrow query can return fewer results than the requested number.

Does Bing Search cost more for more results?

No. Bing Search costs 1 credit per call at every result count. A call for 50 results and a call for 5 results both cost 1 credit, or $0.02.

Is Bing Search cheaper than the Google Search Scraper?

Above 5 results, yes. Bing Search bills 1 credit per call, and the Google Search Scraper bills 0.2 credits per organic result. Bing Search costs less for plain links, because one call returns up to 50 results for 1 credit.

Why does a request with only a query field fail?

The stored default of limit and page is 0, and the search service accepts 1 to 50 and 1 to 20. A request without both parameters returns a 422 error. Send limit and page in every request.

Can you send a num_results or a cache field to Bing Search?

No. Bing Search accepts query, limit and page. Any other field returns a 400 error that names the field. Send the result count in limit.

Does Bing Search need a Bing or Azure account?

No. Bing Search needs only your RichAPI key in the x-api-key header. It consumes no Azure quota and needs no search contract with Microsoft.

How do you read result 11 to result 20 of a query?

Set limit to 10 and page to 2. Bing Search reads the second page of the Bing results, and the response starts at Bing result 11.

Does a cached Bing Search call cost a credit?

Yes. A cached call costs 1 credit, the same as a live call. The meta.cache_hit field reports true for a response that came from the cache.

Related articles

Did this answer your question?