serper.live
TR Create account
DEVELOPER DOCUMENTATION

API documentation

Connect your application to live Google results from Türkiye.

● The API is configured for live Türkiye searches. Create a token and add credit to start.
01 / ACCESS

Authentication

Create a token in your account and send it as a Bearer token over HTTPS.

API tokens →
02 / ENDPOINT

Search request

Send a POST request with a keyword, country, language, and device.

curl -X POST https://api.serper.live/v1/search \
  -H "Authorization: Bearer sl_live_YOUR_TOKEN" \
  -H "Idempotency-Key: 0199860b-2f4e-7a1c-9b3d-5e6f70819a2b" \
  -H "Content-Type: application/json" \
  -d '{"query":"istanbul coffee shops","country":"TR","language":"tr","device":"desktop"}'
03 / JSON

Response shape

A successful response includes current organic results and request metadata. The executor may add further result types.

{
  "requestId": "6b1f…",
  "query": "istanbul coffee shops",
  "country": "TR",
  "language": "tr",
  "device": "desktop",
  "fetchedAt": "2026-09-26T14:00:00.000Z",
  "latencyMs": 18342,
  "price": 0.1,
  "currency": "USD",
  "organic": [
    { "position": 1, "title": "…", "url": "https://…", "domain": "example.com", "snippet": "…" }
  ]
}
04 / ACCOUNTING

Billing and errors

The quoted price is reserved before execution. Successful requests are charged; failed requests are refunded. HTTP 402 means insufficient credit, 409 an Idempotency-Key conflict, and 503 that the service is at capacity.

05 / CONSTRAINTS

Limits

Keywords may contain up to 120 characters. Türkiye (TR) is the first available country. Use a unique Idempotency-Key for each request.