docs / serp

Search Results

Search results from Bing, Yandex and more.

base /serp/v12 endpoints

post/serp/v1/search1 credit

Bing organic web search results — returns ranked pages with title, URL, snippet, answer boxes and related searches. Use mkt or gl to target a country.

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.
device	optional	desktop · mobile	User-agent profile. Only 'mobile' changes behavior; any other value is desktop.

Try in playground →

post/serp/v1/news1 credit

Bing News results for a keyword — article title, source, URL and snippet, sorted by recency.

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.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/serp/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
}