Google · organic vertical
Google SERP API
Google organic results, normalized.
Send q, country and hl to one Google endpoint and read ranked organic rows as JSON. Google and Ecosia accept hl for language. News, Images and task endpoints are available for Google only.
curl -X POST https://kieapi.com/v1/serp/google/organic \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -H "Idempotency-Key: rank-check-0001" \
-d '{"q":"running shoes","country":"DE","hl":"de"}'Omitted fields default to country=US, hl=en, device=desktop.
Google Organic SERP
The Google organic SERP API: POST /v1/serp/google/organic returns organic[] with rank, title, url, display_url and snippet, plus organic_count.
rank
Type: integer
Nullable: yes
Notes: Position in the parsed organic list.
title
Type: string
Nullable: no
Notes: Result title as shown on the results page.
url
Type: string
Nullable: no
Notes: Destination URL of the result.
display_url
Type: string
Nullable: yes
Notes: The breadcrumb-style URL shown under the title.
snippet
Type: string
Nullable: yes
Notes: Description text under the result.
{"engine":"google","query":{"q":"running shoes","country":"DE"},
"request_url":"<request_url>","status_code":200,"classification":"<classification>",
"organic":[{"rank":1,"title":"…","url":"https://…","display_url":"…","snippet":"…"}],
"modules":{},"organic_count":10}modules is an open object; no specific sub-module is promised.
Locale matrix: country × hl
Google sessions are chosen per country and interface language, so set both when the market matters.
United States, English
country: US (default)
hl: en (default)
Typical use: Baseline rank checks
Germany, German
country: DE
hl: de
Typical use: Local-language results for the German market
Japan, Japanese
country: JP
hl: ja
Typical use: Japanese-language results for Japan
- country: 2–8 characters, default US.
- hl: 2–16 characters, default en.
- device: defaults to desktop. mobile and tablet appear in the schema but are UNVERIFIED; do not rely on them yet.
Optional queue for bulk Google jobs
The same body can be enqueued with POST /v1/serp/google/organic/tasks (202 Accepted with a task id), then read with GET /v1/serp/tasks/{task_id}. You poll; there is no callback.
Sibling Google verticals
Google Images
POST /v1/serp/google/images returns images[] with source_url and domain.
Launch status for this page
Check engine availability before choosing an endpoint. Google also supports News, Images and asynchronous tasks.
- GoogleGoogle is callable today with a Bearer API key.
SERP searches are charged per successful search at a display rate of 2 Credits per search; failed searches are not charged. Polling task status is free. The current rate is on Pricing.
What this is not
- No AI Overviews, knowledge graph or ads fields.
- No Google Shopping, Maps or Scholar verticals.
- Structured JSON only; no raw HTML deliverable.
- No webhook or callback; tasks are polled.
Frequently asked questions
Is this a Google organic SERP API?
Yes. POST /v1/serp/google/organic returns organic[] with rank, title, url, display_url and snippet, plus organic_count. See the Google Organic SERP section (#organic).
Which locale parameters exist?
country (default US) and hl (default en). device defaults to desktop; mobile and tablet are not verified yet.
What happens if the session pool is empty?
The request returns 503: serp_session_pool_unavailable is mapped to 503 service_unavailable and nothing is billed.
Does a zero-result search cost Credits?
Yes. A successful search that returns an empty organic list still counts as one completed search.
Are AI Overviews included?
No. This product does not promise AI Overview fields.
Plan your Google organic integration
Get an API key, then point your client at /v1/serp/google/organic with the country and hl pairs you track.