Reef AI: ask for any data. Try it
This page is the Bing Search parameter reference. What the data is used for, a real sample and pricing are on Bing Search API: what you get →
Search & SEO

Bing Search API & Scraper: parameters and responses

This is the reference for the 5 Bing Search endpoints under /bing/v1 (search, news, images, videos and autocomplete) and their 12 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.

The Bing Search API returns Bing's web, news, image and video results as clean JSON: ranked web results with title, URL, snippet, date and site name, plus related searches and people-also-ask questions, in any market.

5 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Every result set is verified before it is returned, so you get either real results, an honest 404 or a retryable error. One ReefAPI key, one shared credit pool, the standard envelope.

Reference

What each action returns, measured on 2026-11-06

Every row below comes from a live call made on 2026-11-06 (207 calls across the five actions, all of which returned rows). Use it to see which fields you can build on and how paging and locale behave.

Action or parameterWhat comes backMeasured detail
searchresults[] with position, title, url, displayed_url, domain, site_name, favicon, snippet, date; plus related_searches[], people_also_ask[], ads[], knowledge_panelcount=30 for "best laptop 2026" returned 21 rows, every one with title, url, snippet, site_name and favicon, 20 with a date; 8 related searches and 4 people-also-ask questions. ads and knowledge_panel appear only when Bing shows them.
search pagingpage or first; data.page_offset is the first row's positionpage=2 returned page_offset 11 and positions 11 to 20, and the next page starts where the previous one ended: pages 1, 2 and 3 of "rust borrow checker explained" returned 30 rows at positions 1 to 30 with no position skipped.
newsnews[] with position, title, url, source, snippet, published, thumbnail_urlcount=30 for "tesla" returned 30 articles, 30 unique URLs, all six fields on all 30. freshness accepts hour, day, week, month and the short forms 24h, 7d, 30d.
imagesimages[] with position, title, image_url, source_url, thumbnail_url, domain, width, height, description35 rows for "eiffel tower at night" with image_url, source_url, title, thumbnail, width and height on all 35; description is usually empty.
videosvideos[] with position, title, url, duration, platform, thumbnail_url, publisher, views, published, description20 rows for "how to make pizza": url, title, duration, platform, publisher, views and upload age on 20 of 20, thumbnail on 13. platform is a clean name (YouTube, TikTok).
autocompletesuggestions[], an ordered list of plain strings16 suggestions for "best lap" (en-US) and 12 for "beste lap" (de-DE) in under a second.
mkt / gl / hl (cc / setlang)data.mkt echoes the market that was used"car insurance" led with geico.com for gl=us, comparethemarket.com for gl=gb and vergleich.de for mkt=de-DE.

total_estimate is Bing's own "about N results" headline, an estimate rather than a number you can paginate against.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/bing/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "q": "best laptop 2026",
    "gl": "us"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "bing",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 2273.7,
    "record_count": 20,
    "bytes": 474368,
    "cache_hit": false,
    "completeness_pct": 100,
    "verification": "19/20 rows match >=2 of 2 query terms (95%; 2/2 terms seen at all)",
    "phrase_relaxed": false,
    "relevance": {
      "rows": 20,
      "query_terms": 2,
      "terms_seen": 2,
      "matching_rows": 19,
      "match_pct": 95
    },
    "operators_supported": true,
    "bing_fallback": "bing alakasız döndü (0/10 rows match >=2 of 2 query terms (0%; 1/2 terms seen at all)) → brave",
    "charged_credits": 1,
    "version": "2.0.0"
  },
  "data": {
    "engine": "brave",
    "query": "best laptop 2026",
    "page_offset": 0,
    "count": 20,
    "results": [
      {
        "position": 1,
        "title": "The Best Laptops We've Tested (September 2026) | PCMag",
        "url": "https://www.pcmag.com/picks/the-best-laptops",
        "displayed_url": "pcmag.com › home › best products › laptops",
        "snippet": "Apple's 2026 MacBook Air is largely unchanged on the outside, but its exceptional build pairs up with an even faster M5 chip and a major storage upgrade to secure its spot as a top-value ultraportable.",
        "published_date": "2026-09-22",
        "date_available": true
      },
      {
        "position": 2,
        "title": "Best Laptops (2026): My Top Recommendations After Testing Hundreds | WIRED",
        "url": "https://www.wired.com/story/best-laptops/",
        "displayed_url": "wired.com › gear › laptops › the best laptops",
        "snippet": "For premium laptops, you’ll want something like the Intel Core Ultra 258V or Qualcomm Snapdragon X Elite. Meanwhile, for budget laptops, Snapdragon X is the best choice. And for gaming laptops, I’d recommend something from AMD, such as the ...",
        "published_date": "2026-08-24",
        "date_available": true
      },
      {
        "position": 6,
        "title": "The 15 Best Laptops of 2026 | Reviews by Wirecutter",
        "url": "https://www.nytimes.com/wirecutter/reviews/best-laptops/",
        "displayed_url": "nytimes.com › electronics › laptops › the best laptops",
        "snippet": "Why we like this one: The Apple MacBook Pro (14-inch, M5 Pro, 2026) combines a sharp display that’s color-accurate out of the box with Apple’s powerful and power-efficient M5 Pro processor.",
        "published_date": "2026-09-02",
        "date_available": true
      }
    ],
    "related_searches": [],
    "answer_box": null
  }
}
Actions

What the Bing Search API does

ActionDescriptionConcrete use caseKey params
searchBing web search results: ranked organic pages with title, URL, snippet, date and site name, plus ads, related searches, people-also-ask questions and a knowledge panel when Bing shows them. Filter by country and language (mkt, or gl + hl), SafeSearch and recency; up to 50 results per call; paginate with page or first. Every result set is verified against a second read of Bing's index before it is returned, so you never receive confident-looking rows about a different subject. A query with no matches returns 404; a temporary failure returns a retryable error, never a false 404.SEO teams call search to get bing web search results.q, engine, depth, mkt, gl, ...
newsBing News articles for a keyword — title, URL, source, snippet, publish age and thumbnail, newest first. Filter by country/language and recency (past hour, day, week, month); up to 100 articles per call. Bing News only indexes recent articles, so an old or very niche topic can legitimately return 404.Content strategists call news to get bing News articles for a keyword.q, mkt, gl, hl, count, ...
imagesBing image search — full-size image URL, the page it appears on, title, thumbnail and (when available) pixel size and description. About 35 images per page; paginate with page or first.Rank trackers call images to get bing image search.q, mkt, gl, hl, count, ...
videosBing video search — watch-page URL, title, thumbnail, duration and hosting platform (YouTube, TikTok, Dailymotion, …) for every result; publisher/channel, views, upload age and description when Bing shows them. About 30 videos per page.AI answer-monitoring tools call videos to get bing video search.q, mkt, gl, hl, count, ...
autocompleteBing search autocomplete — the query suggestions Bing shows while typing. Fast and cheap; useful for keyword research.SEO teams call autocomplete to get bing search autocomplete.q, mkt, gl, hl
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/bing/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"q":"best laptop 2026","gl":"us"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.bing.search with {"q":"best laptop 2026","gl":"us"}.
Use cases

Who uses this API and why

  • SEO tools call search to track Bing rankings per country.
  • Research products use news, images and videos for broader coverage.
  • AI pipelines use search as a retrieval source for grounding.
FAQ

Questions developers ask before integrating

Can a search return results about the wrong thing?

Not as a successful answer. Every result set is checked against a second read of Bing's index before it is returned, and a page about a different subject is replaced or rejected. Nonsense queries in our 2026-11-06 test set returned 404 (occasionally a retryable error) rather than filler. A temporary failure returns a retryable error, never a false 404.

Why did I get fewer results than count?

count is a ceiling. In our 2026-11-06 comparison the default count of 10 returned 10 rows on 52 of 56 searches, and count=30 returned 24 to 30. A page comes back short when Bing's index itself has fewer distinct results for those positions; the rows are not filled from the next page, so paging never repeats or skips a position. Read data.count for what you actually got, and page with page or first for more.

Are site: and quoted phrases applied?

Yes. A site:reddit.com query returned reddit.com rows, and an exact quoted phrase with no matches returns 404 instead of loosely related pages.

Which countries and languages are supported?

Any market as mkt (language-COUNTRY, for example en-GB or de-DE) or as gl plus hl. Our test set covered 20 markets and seven scripts, including Japanese, Korean, Chinese, Arabic, Hindi and Ukrainian queries, and all returned rows. meta.market_applied is false when a local market could not be applied.

Why does a news search return 404 when web search finds pages?

Bing News only indexes recent articles. A niche or old topic can have none, and that answer was identical on every attempt we measured. Widen the query or use the search action for older material.

Does SafeSearch work?

safe=strict removes adult sites (verified on an adult-leaning query on 2026-11-06). safe=moderate is the usual setting. safe=off is not guaranteed to show everything Bing would show a signed-in user.

What is the Bing Search API?

Bing Search API is a ReefAPI endpoint group for bing search It returns live JSON through POST requests under /bing/v1.

Is the Bing Search API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Bing Search calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Bing Search login or account?

No login to Bing Search is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Bing Search data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Bing Search API use?

Bing Search actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Bing Search from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call bing actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Bing Search API a Bing Search scraper?

It is the managed alternative to a DIY Bing Search scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same bing search back as clean JSON.

Why does my Bing Search scraper keep getting blocked?

Most Bing Search scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

docs / bing

Bing Search

Bing Search

base /bing/v15 endpoints
post/bing/v1/news1 credit

Bing News articles for a keyword — title, URL, source, snippet, publish age and thumbnail, newest first. Filter by country/language and recency (past hour, day, week, month); up to 100 articles per call. Bing News only indexes recent articles, so an old or very niche topic can legitimately return 404.

ParameterAllowed / rangeDescription
qrequired—Search query. Search operators such as site:example.com and "exact phrase" are applied.
mktoptional—Bing market as lang-COUNTRY (e.g. en-US, en-GB, de-DE, fr-FR, ja-JP). Sets the country and language of the results. If omitted it is built from gl + hl (default en-US).
gloptional—Country as a 2-letter ISO-3166 code (us, gb, de, in, br, …). `cc` is accepted as the same parameter.
hloptional—Language as an ISO-639 code (en, de, fr, …). `setlang` is accepted as the same parameter.
count = 15optional1–100How many articles to return (1-100, default 15).
freshnessoptionalhour · day · week · monthRestrict results to a recency window. Short forms (24h, 7d, 30d, d/w/m) are accepted; an unrecognized value is ignored.
Try in playground →
post/bing/v1/images1 credit

Bing image search — full-size image URL, the page it appears on, title, thumbnail and (when available) pixel size and description. About 35 images per page; paginate with page or first.

ParameterAllowed / rangeDescription
qrequired—Search query. Search operators such as site:example.com and "exact phrase" are applied.
mktoptional—Bing market as lang-COUNTRY (e.g. en-US, en-GB, de-DE, fr-FR, ja-JP). Sets the country and language of the results. If omitted it is built from gl + hl (default en-US).
gloptional—Country as a 2-letter ISO-3166 code (us, gb, de, in, br, …). `cc` is accepted as the same parameter.
hloptional—Language as an ISO-639 code (en, de, fr, …). `setlang` is accepted as the same parameter.
count = 35optional1–60How many images to return (1-60, default 35).
pageoptional1–1-based result page (about 35 items per page).
firstoptional1–1-based result offset (alternative to page; first=11 is page 2).
safeoptionaloff · moderate · strictSafeSearch level. An unrecognized value is ignored.
Try in playground →
post/bing/v1/videos1 credit

Bing video search — watch-page URL, title, thumbnail, duration and hosting platform (YouTube, TikTok, Dailymotion, …) for every result; publisher/channel, views, upload age and description when Bing shows them. About 30 videos per page.

ParameterAllowed / rangeDescription
qrequired—Search query. Search operators such as site:example.com and "exact phrase" are applied.
mktoptional—Bing market as lang-COUNTRY (e.g. en-US, en-GB, de-DE, fr-FR, ja-JP). Sets the country and language of the results. If omitted it is built from gl + hl (default en-US).
gloptional—Country as a 2-letter ISO-3166 code (us, gb, de, in, br, …). `cc` is accepted as the same parameter.
hloptional—Language as an ISO-639 code (en, de, fr, …). `setlang` is accepted as the same parameter.
count = 30optional1–60How many videos to return (1-60, default 30).
pageoptional1–1-based result page (about 30 items per page).
firstoptional1–1-based result offset (alternative to page; first=11 is page 2).
safeoptionaloff · moderate · strictSafeSearch level. An unrecognized value is ignored.
Try in playground →
post/bing/v1/autocomplete1 credit

Bing search autocomplete — the query suggestions Bing shows while typing. Fast and cheap; useful for keyword research.

ParameterAllowed / rangeDescription
qrequired—Search query. Search operators such as site:example.com and "exact phrase" are applied.
mktoptional—Bing market as lang-COUNTRY (e.g. en-US, en-GB, de-DE, fr-FR, ja-JP). Sets the country and language of the results. If omitted it is built from gl + hl (default en-US).
gloptional—Country as a 2-letter ISO-3166 code (us, gb, de, in, br, …). `cc` is accepted as the same parameter.
hloptional—Language as an ISO-639 code (en, de, fr, …). `setlang` is accepted as the same parameter.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.