Skip to content

New AI assistant answers: ChatGPT, Gemini, Copilot and AI Mode by API

SerpKite
Get API key
Docs menu / Google Search

Google Search

Organic results, knowledge graph, answer box, AI Overview, People Also Ask, related searches, top stories and sitelinks.

POST https://api.serpkite.com/v1/search Credits: 1 per page (7 for num=100) Try in playground
View as Markdown

The main Google web search endpoint. One call returns the whole results page: organic results in results with resolved destination URLs, knowledge graph, answer box, AI Overview, People Also Ask, related searches, top stories and the local pack when Google shows them.

related_searches is always present (an empty array when Google shows none); the other extras appear only when the page has them.

Request body

Send a JSON object with Content-Type: application/json. The same parameters also work as a query string on GET /v1/search. JSON arrays are rejected: to run many queries at once, use POST /v1/batches at half price. Unknown parameters return 400 invalid_request with a message that names the replacement; see strict validation.

ParameterTypeDefaultDescription
q requiredstringThe search query. Required. Up to 2,048 characters.
countrystringusCountry to search from, as a two-letter ISO code (us, gb, de, in…). Defaults to the country a location ends in.
languagestringenInterface language, as a language code with an optional region (en, de, pt-BR, zh-TW…).
locationstringCanonical location for local results, e.g. "Austin, Texas, United States". Ending in a country name also sets country.
uulestringGoogle-encoded location string. Use instead of location if you already have it.
numinteger10Results per call, 1–100. Up to 10 returns one page of 10 (1 credit); above 10 on search and news fetches whole pages as a depth bundle, and 100 costs 7 credits instead of 10. On images a page holds up to 100 images and num (default all) is how many of them come back.
pageinteger1Results page, 1–10. Each page is billed separately.
timestringRestrict to recent results. Shorthand for tbs=qdr:*. One of: hour, day, week, month, year.
tbsstringRaw Google tbs filter, e.g. qdr:w2 or cdr:1,cd_min:1/1/2026,cd_max:1/31/2026. Overrides time.
devicestringdesktopWhich SERP layout to fetch. One of: desktop, mobile.
safestringoffSafeSearch filtering. One of: off, active.
autocorrectbooleantrueLet Google correct misspelled queries. Set false to search the exact text.
formatstringjsonResponse format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. One of: json, compact, markdown.
fieldsstringComma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens.
include_contentinteger0Also fetch the top N result pages (0–5) as Markdown. +1 credit per page.
max_ageintegerAccept a cached result up to this many seconds old. Cache hits cost 50% of the credits.
adsbooleanfalseInclude sponsored results in ads.
enginestring or arraygoogleWhich search providers may answer. google is Google only (SerpKite still retries Google internally); auto falls back to other providers when Google is blocked or times out; consensus (search only) asks several independent indexes in parallel, merges the results by URL, ranks them by agreement and lists each result's sources, at the sum of one page per provider that returned results; a provider name or a list (e.g. google,brave) restricts the request to those. meta.engine names the provider that answered. One of: google, auto, consensus, brave, bing, yahoo, duckduckgo, mojeek, wikipedia, yandex.
include_domainsstring[]Only results from these sources, up to 20: a domain (example.com, subdomains match), a path prefix (github.com/org) or a TLD (.gov). Compiled to site: operators and enforced on the results. Search, news, images, videos.
exclude_domainsstring[]Drop results from these sources, up to 20, same formats as include_domains. Search, news, images, videos.
boost_domainsstring[]Move results from these sources to the top without filtering out the rest, up to 20. Search and news.
start_datestringOnly results published on or after this date (YYYY-MM-DD). Google's custom date range; can't be combined with time or tbs.
end_datestringOnly results published on or before this date (YYYY-MM-DD).
highlightsbooleanfalseWith include_content: return up to 3 query-ranked passages (~600 characters each) per fetched page in results[].highlights instead of the whole page. No extra credits.
include_answerbooleanfalseAdd a short answer written by Claude over the results, with [n] citations, in answer.text and answer.citations. +2 credits (+4 with include_content, when it reads the pages), refunded (with a meta.warnings entry) when the model fails. Search and news.

Example request

Authenticate with Authorization: Bearer $SERPKITE_API_KEY (GET requests may pass ?api_key= instead). The official SDKs read SERPKITE_API_KEY for you. See Authentication.

curl https://api.serpkite.com/v1/search \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"best espresso machine 2026","country":"us","language":"en"}'

Response fields

FieldTypeDescription
requestobjectThe normalised request, with defaults filled in: endpoint, engine, q, country, language, location, num, page, device, autocorrect…
results[]arrayOrganic results: position, title, link (resolved), domain, displayed_link, snippet, date, sitelinks[], attributes, rating, rating_count, published_at (ISO 8601, when date parses), content (with include_content), highlights (with highlights: true). link_resolved: false marks a result whose destination Google hadn't released in time: it keeps its position, link is the google.com/goto redirect and domain the host Google displayed.
answer_boxobjecttitle, answer, snippet, snippet_highlighted[], link.
ai_overviewobjectGoogle's AI Overview, when the page showed one: text, markdown (citations as [n](link)) and sources[] (position, title, link, domain, snippet, cited). Included in the search price. Google shows it for many informational and commercial queries, not for every query or country. For Google AI Mode, use /v1/ai_mode.
knowledge_graphobjecttitle, type, website, image_url, description, description_source, description_link, attributes.
people_also_ask[]arrayquestion, snippet, title, link.
related_searches[]arrayquery.
top_stories[]arrayNews items: position, title, link, domain, source, date, published_at, image_url; link_resolved: false when link is still Google's redirect.
places[]arrayLocal pack, same shape as /v1/maps results.
ads[]arraySponsored results (only with ads: true).
answerobjectOnly with include_answer: true: text (Markdown with [n] citation markers) and citations[] (index, title, link, domain). See Cited answers.
metaobjectrequest_id, credits_used, cached, cached_at, engine (the provider that answered), route (provider attempts, see Search providers), latency_ms, parse_quality (ok, partial, empty), resolved_urls, unresolved_links (results whose link is still a Google redirect); llm (provider, model, input_tokens, output_tokens) and warnings when an AI step ran or failed.

Every billed response also carries credit and latency headers (X-Credits-Used, X-Credits-Remaining, X-Request-Id…).

Example response

200 OK · illustrative
{
  "request": {
    "endpoint": "search",
    "engine": "google",
    "q": "best espresso machine 2026",
    "country": "us",
    "language": "en",
    "num": 10,
    "page": 1,
    "device": "desktop",
    "autocorrect": true
  },
  "results": [
    {
      "position": 1,
      "title": "The Best Espresso Machines of 2026, Tested and Reviewed",
      "link": "https://www.example.com/best-espresso-machines",
      "domain": "example.com",
      "displayed_link": "https://www.example.com › best-espresso-machines",
      "snippet": "We pulled more than 1,200 shots on 42 machines to find the best espresso makers for every budget, from beginner-friendly to prosumer.",
      "date": "Sep 12, 2026",
      "sitelinks": [
        {
          "title": "Best budget pick",
          "link": "https://www.example.com/best-espresso-machines#budget"
        },
        {
          "title": "Best dual boiler",
          "link": "https://www.example.com/best-espresso-machines#dual-boiler"
        }
      ]
    },
    {
      "position": 2,
      "title": "Espresso Machine Buying Guide (2026)",
      "link": "https://coffee.example.org/guides/espresso",
      "domain": "coffee.example.org",
      "displayed_link": "https://coffee.example.org › guides › espresso",
      "snippet": "Single boiler, heat exchanger or dual boiler? What the specs mean and which features are worth paying for."
    },
    {
      "position": 3,
      "title": "r/espresso: What machine would you buy in 2026?",
      "link": "https://www.reddit.com/r/espresso/comments/abc123/",
      "domain": "reddit.com",
      "displayed_link": "https://www.reddit.com › r › espresso",
      "snippet": "Discussion thread with 480 comments comparing entry-level and prosumer machines."
    }
  ],
  "people_also_ask": [
    {
      "question": "What is the #1 rated espresso machine?",
      "snippet": "Reviewers most often rank dual-boiler machines with PID control at the top…",
      "link": "https://www.example.com/best-espresso-machines"
    },
    {
      "question": "Is a $500 espresso machine worth it?",
      "snippet": "For daily drinkers, a mid-range machine usually pays for itself within a year…",
      "link": "https://coffee.example.org/guides/espresso"
    }
  ],
  "related_searches": [
    {
      "query": "best espresso machine under $500"
    },
    {
      "query": "best espresso machine for beginners"
    },
    {
      "query": "dual boiler vs heat exchanger"
    }
  ],
  "meta": {
    "request_id": "req_01J8ZK4M6Q2V7",
    "credits_used": 1,
    "cached": false,
    "engine": "google",
    "latency_ms": 942,
    "parse_quality": "ok",
    "resolved_urls": true
  }
}

Errors

Errors use one shape: {"error":{"code","message","request_id"}}. Errors are never billed. Full list in Errors.

StatusCodeMeaning
400invalid_requestA parameter is missing or invalid.
401unauthorizedThe API key is missing, invalid or revoked.
402insufficient_creditsYour balance is too low. Buy a pack or wait for the monthly free grant.
429rate_limitedToo many requests per second for your plan. Retry after the Retry-After header.
503upstream_errorGoogle could not be fetched or parsed. Not billed; retry after Retry-After.

Notes

  • Set format: "markdown" or "compact" to cut tokens, or project fields with fields (e.g. results.title,results.link,knowledge_graph). See Output formats.
  • num: 100 returns the top 100 in one call for 7 credits. See Pagination and depth.
  • GET /v1/search?q=… works too, with the same parameters in the query string.
  • include_answer: true adds a short answer written by Claude over the results, with [n] citations: +2 credits, or +4 with include_content (refunded with a meta.warnings entry when the model fails). For an answer from the pages themselves, use /v1/answer.