Google Web Search — API reference

POST

Available

/google/search

Google Web Search

Search Google web results with q, language hl, country gl and a supported device. Result sections depend on the query and upstream response.

type

result

organic

Billing

1 credits

Search Google web results with q, language hl, country gl and a supported device. Result sections depend on the query and upstream response.

Parameters

FieldTypeAvailabilityDescription

q

required

string

required

Search query string.

hl

optional

string

optional

Language code. Defaults to en.

gl

optional

string

optional

Country code. Defaults to us.

page

optional

number

optional

1-based page number. Defaults to 1.

device

optional

"default" | "pc" | "mobile"

optional

Google Search only. Use default for automatic routing, pc for desktop sessions, or mobile for mobile sessions.

json

{
  "device": "mobile",
  "gl": "us",
  "hl": "en",
  "q": "coffee shops"
}

Open in Playground

Response fields

FieldTypeAvailabilityDescription

query

required

string

required

Normalized query from the request.

page

required

number

required

Current 1-based page number.

organic

optional

OrganicResult[]

When organic results are parsed.

Organic search results.

featured_snippet

optional

FeaturedSnippet

When Google shows a featured snippet.

Featured snippet answer card, returned separately from organic results.

top_stories

optional

TopStory[]

When the SERP contains top stories.

Top stories module.

people_also_ask

optional

PAA[]

When People Also Ask is present.

Question, answer, and source links.

knowledge_graph

optional

KnowledgeGraph

When a knowledge panel is parsed.

Entity panel data.

related_searches

optional

string[]

When related search suggestions are found.

Related search queries.

OrganicResult Result item schema

FieldTypeAvailabilityDescription

rank

required

number

required

1-based ranking position in this response.

position

optional

number

Alias for rank when available.

Normalized rank alias for clients that expect position.

title

required

string

required

Result title.

link

required

string

required

Primary link returned by the parser.

url

optional

string

Present for normalized result links.

Canonical target URL, usually the same value as link.

source_url

optional

string

Only when Google redirect/source URL is observed.

Original Google URL kept for debugging and provenance.

display_url

optional

string

When Google display text or a domain can be derived.

Display URL or source domain.

display_link

optional

string

When Google display text is present.

Raw Google display link text.

snippet

optional

string

When a snippet is parsed.

Organic result summary.

date

optional

string

When Google includes a date in the snippet.

Raw date text extracted from snippet.

published_at

optional

string

Alias for parsed date when available.

Normalized date alias.

icon

optional

string

When a favicon/image is exposed.

Result icon URL.

sitelinks

optional

{ title, link, url, source_url?, display_url? }[]

When sitelinks are present.

Nested sitelinks for the organic result.

Code and response examples

bash

curl -X POST 'https://api.serpbase.dev/google/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'

Existing Google request example

bash

curl -X POST https://api.serpbase.dev/google/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "python asyncio",
    "hl": "en",
    "gl": "us",
    "page": 1,
    "device": "default"
  }'

Notes

Search grounding, SEO checks, answer extraction.

Search can also return ai_overview, weather, finance, flight, and result_stats when those modules appear in the SERP.