docs / bing

Bing Search API

base /bing/v14 endpoints

post/bing/v1/search1 credit

Bing web search results — ranked organic pages with title, URL, snippet, answer box and related searches. Filter by market/language (mkt or gl/hl), SafeSearch and recency (freshness), with offset pagination.

Parameter		Allowed / range	Description
q	required	—	Search query (the keywords to look up).
engine = bing	optional	bing · yandex	Search engine to query. Use bing for live results.
mkt	optional	—	Bing market as lang-COUNTRY (e.g. en-US, en-GB, de-DE). Controls locale regardless of exit IP. If omitted it is derived from gl + hl.
gl	optional	—	Country as a 2-letter ISO-3166 code (e.g. us, gb, de) — used to build mkt when mkt is absent.
hl	optional	—	Language as an ISO-639 code (e.g. en, de) — used to build mkt when mkt is absent.
count	optional	1–30	Requested results (1-30; clamped). Note: Bing caps organic search results at ~10 per page regardless of count.
page	optional	1–	1-based page for offset pagination (best-effort: Bing's bare pagination is session/IP-sensitive and may repeat page 1).
first	optional	1–	Explicit 1-based result offset (alternative to page; first=11 ~ page 2). Best-effort.
safe	optional	off · moderate · strict	Bing SafeSearch level (search only). An unrecognized value is ignored.
freshness	optional	day · week · month	Restrict results to a recency window (Bing `qft` interval). Single-letter forms d/w/m are also accepted; an unrecognized value is ignored.
device	optional	desktop · mobile	User-agent profile. Only 'mobile' changes behavior; any other value is desktop.

Try in playground →

post/bing/v1/news1 credit

Bing News results for a keyword — article title, source, URL and snippet, sorted by recency. Filter by market and a recency window (freshness).

Parameter		Allowed / range	Description
q	required	—	Search query (the keywords to look up).
mkt	optional	—	Bing market as lang-COUNTRY (e.g. en-US, en-GB, de-DE). Controls locale regardless of exit IP. If omitted it is derived from gl + hl.
gl	optional	—	Country as a 2-letter ISO-3166 code (e.g. us, gb, de) — used to build mkt when mkt is absent.
hl	optional	—	Language as an ISO-639 code (e.g. en, de) — used to build mkt when mkt is absent.
count	optional	1–50	Requested results (1-50; clamped). Note: Bing caps organic search results at ~10 per page regardless of count.
freshness	optional	day · week · month	Restrict results to a recency window (Bing `qft` interval). Single-letter forms d/w/m are also accepted; an unrecognized value is ignored.

Try in playground →

post/bing/v1/videos1 credit

Bing video search results — watch-page URL, thumbnail, duration and hosting platform (YouTube/Dailymotion/…) for every result; publisher/channel, view count, publish date and description when Bing exposes them. ~30 videos per page; paginate for more.

Parameter		Allowed / range	Description
q	required	—	Search query (the keywords to look up).
mkt	optional	—	Bing market as lang-COUNTRY (e.g. en-US, en-GB, de-DE). Controls locale regardless of exit IP. If omitted it is derived from gl + hl.
gl	optional	—	Country as a 2-letter ISO-3166 code (e.g. us, gb, de) — used to build mkt when mkt is absent.
hl	optional	—	Language as an ISO-639 code (e.g. en, de) — used to build mkt when mkt is absent.
page	optional	1–	1-based result page (each page ≈ 30 items).
first	optional	1–	Explicit 1-based result offset (alternative to page; first=11 ~ page 2). Best-effort.
safe	optional	off · moderate · strict	Bing SafeSearch level (search only). An unrecognized value is ignored.

Try in playground →

post/bing/v1/autocomplete1 credit

Bing search autocomplete — query suggestions / typeahead from Bing's public suggest endpoint (fast, no anti-bot). Useful for keyword research.

Parameter		Allowed / range	Description
q	required	—	Search query (the keywords to look up).
mkt	optional	—	Bing market as lang-COUNTRY (e.g. en-US, en-GB, de-DE). Controls locale regardless of exit IP. If omitted it is derived from gl + hl.
gl	optional	—	Country as a 2-letter ISO-3166 code (e.g. us, gb, de) — used to build mkt when mkt is absent.
hl	optional	—	Language as an ISO-639 code (e.g. en, de) — used to build mkt when mkt is absent.

Try in playground →

Example request · search

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","engine":"bing","gl":"us"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}