Skip to content

New Official SDKs for TypeScript, Python and Go

SerpKite
Get API key

Product

Changelog

New endpoints, parameters and dashboard features, by API version. For Google's own changes, see the Google SERP changelog.

v1.0.2

AI Overview and AI Mode removed

SerpKite no longer parses Google's AI Overview or offers the AI Mode endpoint. Web search returns organic results and the other SERP features as before.

Search API (api.serpkite.com/v1)

  • /v1/search drops the ai_overview request parameter and the ai_overview response field.
  • POST /v1/ai-mode is removed.
  • The remote MCP server (/v1/mcp) no longer lists the ai_overview tool.
v1.0.1

Upstream errors are 503

Upstream failures now return 503 with the usual JSON error body and a Retry-After header. The API never returns 502 or 504, because proxies such as Cloudflare replace those bodies and clients could not read the error.

Search API (api.serpkite.com/v1)

  • upstream_error, upstream_blocked and upstream_timeout are 503 (were 502, 502 and 504). The code values are unchanged, the calls are still not billed and safe to retry.
  • Upstream 503s carry Retry-After (a few seconds). The official SDKs already retry 5xx and honour it.
  • Dashboard API: a payment provider outage or an invoice that isn't ready yet is 503 upstream_error with Retry-After (was 502).
v1.0.0

The v1 API and official SDKs

SerpKite's own versioned API: every route under /v1, Bearer auth, one snake_case response envelope for every vertical, a dedicated batches endpoint and official SDKs. The OpenAPI contract is v1.0.0; breaking changes from here on get a new version and a migration note.

Search API (api.serpkite.com/v1)

  • All routes live under /v1: /v1/search, /v1/images, /v1/videos, /v1/news, /v1/maps, /v1/places, /v1/reviews, /v1/shopping, /v1/scholar, /v1/patents, /v1/autocomplete, /v1/lens, /v1/ai-mode, /v1/webpage, /v1/rank, /v1/account, /v1/status. GET /customsearch/v1 is unchanged.
  • Authentication is Authorization: Bearer skt_live_… (GET requests may use ?api_key=). The legacy key header is no longer accepted.
  • One response envelope for every vertical: request (the normalised request), results (the vertical's primary list), vertical extras and meta (request_id, credits_used, cached, latency_ms, parse_quality…).
  • All keys are snake_case: ai_overview, knowledge_graph, people_also_ask, related_searches, displayed_link, image_url, rating_count…
  • Own parameter names: country and language for geo and interface language; reviews take place_id (or cid/fid), sort and page_token (from next_page_token).
  • Strict validation: unknown parameters return 400 invalid_request with a message that names the replacement, for example unknown parameter "type": use the endpoint path.
  • POST /v1/batches queues 1 to 100 requests for one endpoint at half price and returns one job per request. Poll GET /v1/batches/{id} or receive a signed batch.completed webhook. It replaces the batch mode flag and JSON array bodies.
  • POST /v1/rank: the position of a domain for a keyword in the top 10 to 100.
  • Remote MCP server moved to https://api.serpkite.com/v1/mcp (Bearer auth).

Billing

  • The $1,000 and $3,000 credit packs are no longer sold. Self-serve packs run from $10 to $300; larger volumes are quoted on request. Credits already bought never expire, and accounts keep the rate limit of the largest pack they bought.

Official SDKs

  • TypeScript: npm install serpkite (zero dependencies; Node 18+, Bun, Deno, edge).
  • Python: pip install serpkite, with SerpKite and AsyncSerpKite.
  • Go: go get github.com/serpkite/serpkite-go.
  • LangChain: pip install langchain-serpkite (search tools, retriever, webpage loader).
  • CrewAI: pip install "serpkite[crewai]" (SerpKiteSearchTool).
v0.9.0

Preview release

The pre-v1 preview of the SerpKite API, dashboard and billing. Its unversioned routes are superseded by the v1 API.

Search API (api.serpkite.com)

  • JSON search endpoints for Google Search, Images, Videos, News, Maps, Places, Reviews, Shopping, Scholar, Patents, Autocomplete, Lens, AI Mode and a webpage-to-Markdown fetcher.
  • GET /customsearch/v1: a Google Custom Search JSON API–compatible endpoint (key, cx, q, start, num, siteSearch, dateRestrict, searchType=image…).
  • AI Overview in web search at no extra credit.
  • Output formats: format=json|compact|markdown, plus fields= projection.
  • include_content=0–5 fetches the top result pages as Markdown (+1 credit per page).
  • Resolved destination URLs and a canonical domain on every organic result; meta.resolved_urls and meta.parse_quality in every response.
  • num=100 depth bundle (7 credits), max_age cache acceptance (0.5× on a hit).
  • Batch lane at 0.5× credits with polling and signed webhook delivery.
  • Account endpoint: balance, rate limit, plan and this month's usage.
  • Response headers: X-Credits-Used, X-Credits-Remaining, X-Cost-USD, X-Cache, X-Latency-Ms, X-Tokens-Estimate, X-Request-Id.
  • Remote MCP server (streamable HTTP) with search, news, maps, scholar, webpage and AI Overview tools.
  • No-signup playground endpoint, rate limited per IP.

Billing

  • Credit packs from $10 (10,000 credits) to $3,000 (12.5M credits). Credits never expire.
  • Failed, empty and blocked requests are refunded automatically.
  • Free tier: 1,000 credits on signup, 1,500 more after linking GitHub or Google, 1,000 every month.
  • Payments through Polar as merchant of record, with invoices.

Dashboard (app.serpkite.com)

  • Sign in with a magic link (link or 6-digit code), GitHub or Google.
  • Multiple API keys with names, rotation and per-key monthly credit limits. Only a hash of each key is stored.
  • Usage by day, endpoint and key; request log (metadata only); CSV export.
  • Monthly spend cap, low-balance and usage alerts, auto-recharge links, webhook secret rotation.
  • Session management: see and revoke active sessions.

Start building

Get your API key in 30 seconds

2,500 free credits, then 1,000 every month. No credit card.