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		Allowed / range	Description
q	required	—	Search query (the keywords you'd type into Google).
num	optional	1–100	Number of organic results to auto-paginate up to (1-100, ~10 per page). Mutually exclusive with start/page (those request a single explicit page).
start	optional	0–	Explicit result offset for a single page (0=first page, 10=second, ...). Overrides num (fetches just that one page).
page	optional	1–	1-based page number (alternative to start; page 2 = start 10). Overrides num (fetches just that one page).
hl = en	optional	—	UI/results language as an ISO-639 code (Google `hl`), e.g. en, es, de, fr.
gl = us	optional	—	Country bias as a 2-letter ISO-3166 code (Google `gl`), e.g. us, gb, de.
safe	optional	off · medium · high	SafeSearch filtering level. 0/1/2 are also accepted; an unrecognized value is ignored (no filtering applied).
time_range	optional	hour · day · week · month · year	Restrict results by recency (Google qdr:). Single-letter forms (h/d/w/m/y) are also accepted; an unrecognized value is ignored.
site	optional	—	Restrict results to one domain (applied as a `site:` operator).

Try in playground →

post/google-search/v1/news1 credit

Google News results

Parameter		Allowed / range	Description
q	required	—	Search query (the keywords you'd type into Google).
hl = en	optional	—	UI/results language as an ISO-639 code (Google `hl`), e.g. en, es, de, fr.
gl = us	optional	—	Country bias as a 2-letter ISO-3166 code (Google `gl`), e.g. us, gb, de.
time_range	optional	hour · day · week · month · year	Restrict results by recency (Google qdr:). Single-letter forms (h/d/w/m/y) are also accepted; an unrecognized value is ignored.
start	optional	0–	Explicit result offset for a single page (0=first page, 10=second, ...). Overrides num (fetches just that one page).
page	optional	1–	1-based page number (alternative to start; page 2 = start 10). Overrides num (fetches just that one page).

Try in playground →

post/google-search/v1/images1 credit

Google Images results — thumbnails + titles

Parameter		Allowed / range	Description
q	required	—	Search query (the keywords you'd type into Google).
hl = en	optional	—	UI/results language as an ISO-639 code (Google `hl`), e.g. en, es, de, fr.
gl = us	optional	—	Country bias as a 2-letter ISO-3166 code (Google `gl`), e.g. us, gb, de.
safe	optional	off · medium · high	SafeSearch filtering level. 0/1/2 are also accepted; an unrecognized value is ignored (no filtering applied).

Try in playground →

post/google-search/v1/videos1 credit

Google Videos results

Parameter		Allowed / range	Description
q	required	—	Search query (the keywords you'd type into Google).
hl = en	optional	—	UI/results language as an ISO-639 code (Google `hl`), e.g. en, es, de, fr.
gl = us	optional	—	Country bias as a 2-letter ISO-3166 code (Google `gl`), e.g. us, gb, de.
start	optional	0–	Explicit result offset for a single page (0=first page, 10=second, ...). Overrides num (fetches just that one page).
page	optional	1–	1-based page number (alternative to start; page 2 = start 10). Overrides num (fetches just that one page).

Try in playground →

post/google-search/v1/shopping1 credit

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

Parameter		Allowed / range	Description
q	required	—	Search query (the keywords you'd type into Google).
hl = en	optional	—	UI/results language as an ISO-639 code (Google `hl`), e.g. en, es, de, fr.
gl = us	optional	—	Country bias as a 2-letter ISO-3166 code (Google `gl`), e.g. us, gb, de.
num	optional	1–100	Number of organic results to auto-paginate up to (1-100, ~10 per page). Mutually exclusive with start/page (those request a single explicit page).
start	optional	0–	Explicit result offset for a single page (0=first page, 10=second, ...). Overrides num (fetches just that one page).
page	optional	1–	1-based page number (alternative to start; page 2 = start 10). Overrides num (fetches just that one page).

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
}