docs / google-search

Google Search

Google search results and news.

base /google-search/v15 endpoints

post/google-search/v1/search1 credit

Google web SERP — organic + People-Also-Ask + knowledge-panel + answer-box (instant/featured) + related

Parameter	Required
q	required
num	optional
start	optional
page	optional
hl	optional
gl	optional
safe	optional
time_range	optional
site	optional

Try in playground →

post/google-search/v1/news1 credit

Google News tab results (tbm=nws)

Parameter	Required
q	required
hl	optional
gl	optional
time_range	optional
start	optional
page	optional

Try in playground →

post/google-search/v1/images1 credit

Google Images tab results (tbm=isch) — thumbnails + titles

Parameter	Required
q	required
hl	optional
gl	optional
safe	optional

Try in playground →

post/google-search/v1/videos1 credit

Google Videos tab results (tbm=vid)

Parameter	Required
q	required
hl	optional
gl	optional
start	optional
page	optional

Try in playground →

post/google-search/v1/shopping1 credit

Google Shopping tab (tbm=shop) — shopping-filtered results + best-effort $price hint (no structured PLA grid in lite SERP)

Parameter	Required
q	required
hl	optional
gl	optional
num	optional
start	optional
page	optional

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/google-search/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"q":"best laptop 2026","num":10}'

Response shape

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