# SerpKite

> SerpKite is a Google search API built for AI agents: clean JSON or Markdown, official TypeScript/Python/Go SDKs, native LangChain, CrewAI and MCP, credits that never expire.

- Base URL: https://api.serpkite.com. Every route is under `/v1` (`/v1/search`, `/v1/news`, `/v1/images`, `/v1/videos`, `/v1/maps`, `/v1/places`, `/v1/reviews`, `/v1/shopping`, `/v1/scholar`, `/v1/patents`, `/v1/autocomplete`, `/v1/lens`, `/v1/webpage`, `/v1/rank`, `/v1/account`, `/v1/status`). `GET /customsearch/v1` serves apps moving off the Google Custom Search JSON API.
- Auth: `Authorization: Bearer skt_live_…` (GET may use `?api_key=`). POST one JSON object (or GET with query params). Parameters: `q`, `country`, `language`, `location`, `num`, `page`, `time`, `device`, `format` (json|compact|markdown), `fields` (e.g. `results.title,results.link,knowledge_graph`), `include_content`, `max_age`. Unknown parameters return 400 naming the replacement.
- Response envelope for every vertical: `request`, `results` (the primary list), vertical extras (`answer_box`, `knowledge_graph`, `people_also_ask`, `related_searches`, `top_stories`, `places`…) and `meta` (`request_id`, `credits_used`, `cached`, `latency_ms`). All keys snake_case. Errors: `{"error":{"code","message","request_id"}}`.
- Batches: `POST /v1/batches` with `{"endpoint":"search","requests":[…up to 100],"webhook_url":"…"}` queues half-price jobs; poll `GET /v1/batches/{id}` or receive a signed `batch.completed` webhook.
- 1 credit = 1 Google results page (10 results). `num=100` = 7 credits. Autocomplete costs 0.5; batch jobs and cache hits 0.5×; Lens 2. Failed, empty and blocked requests are free.
- Packs from $10 for 10,000 credits down to $0.60 per 1,000 (largest pack $300); larger volumes on request (https://serpkite.com/enterprise). Free: 1,000 credits on signup, +1,500 for linking GitHub or Google, 1,000 every month.
- SDKs (key from SERPKITE_API_KEY): TypeScript `npm install serpkite`, Python `pip install serpkite` (sync + async), Go `go get github.com/serpkite/serpkite-go`, LangChain `pip install langchain-serpkite`, CrewAI `pip install "serpkite[crewai]"`. Source: https://github.com/serpkite/serpkite-js, https://github.com/serpkite/serpkite-python, https://github.com/serpkite/serpkite-go, https://github.com/serpkite/langchain-serpkite.
- Remote MCP server: https://api.serpkite.com/v1/mcp (streamable HTTP, Bearer auth). OpenAPI: https://serpkite.com/openapi/serp-api.yaml. All docs in one file: https://serpkite.com/llms-full.txt.

## Docs: Getting started

- [SerpKite documentation](https://serpkite.com/docs.md): Real-time Google search results for AI agents and apps, as JSON, compact JSON or Markdown. Start here for the quickstart, endpoint reference, guides and MCP setup.
- [Quickstart](https://serpkite.com/docs/quickstart.md): Create an API key, install the SDK (or use curl), run your first Google search with SerpKite, read the response and check your credit balance. Takes about five minutes.
- [Authentication](https://serpkite.com/docs/authentication.md): Every SerpKite API call is authenticated with a secret API key, sent as a Bearer token in the Authorization header, or on GET requests as a query parameter.
- [Credits and billing](https://serpkite.com/docs/credits-and-billing.md): SerpKite is prepaid. You buy credit packs that never expire, each call spends a known number of credits, and failed or empty calls are refunded automatically.
- [Rate limits](https://serpkite.com/docs/rate-limits.md): SerpKite limits requests per second per API key. Free keys get 5 per second; buying a pack raises every key to that pack's rate. Over the limit you get a 429 with Retry-After.
- [Errors](https://serpkite.com/docs/errors.md): Every SerpKite error uses the same JSON body with a stable code, a human-readable message and a request ID. Errors are never billed. Here is every code and what to do about it.
- [Response headers](https://serpkite.com/docs/response-headers.md): Every billed SerpKite response tells you what it cost, your remaining balance, whether it came from cache, how long it took and roughly how many LLM tokens it contains.

## Docs: Core concepts

- [Common parameters](https://serpkite.com/docs/parameters.md): Every request parameter the SerpKite search endpoints accept, with types, defaults and allowed values, grouped by what they control.
- [Output formats](https://serpkite.com/docs/output-formats.md): Get Google results as full JSON, token-lean compact JSON or LLM-ready Markdown, and cut them down further with fields projection. X-Tokens-Estimate tells you the size.
- [Localization](https://serpkite.com/docs/localization.md): Search Google as a user in a specific country, language and city with country, language, location, uule and ll, including code tables for common countries and languages.
- [Pagination and depth](https://serpkite.com/docs/pagination-and-depth.md): Page through Google results with page, or fetch up to the top 100 in one call with num. num=100 is a depth bundle that costs 7 credits instead of 10.
- [Caching](https://serpkite.com/docs/caching.md): Accept a recent cached result with max_age and pay half the credits on a hit. How freshness, cache keys, X-Cache and meta.cached work.
- [Search providers](https://serpkite.com/docs/providers.md): Requests are answered by Google by default. With engine=auto (or a per-key setting) SerpKite can fall back to Brave, Bing, Yahoo or DuckDuckGo when Google is unavailable, and always labels the engine that answered.
- [Batch requests](https://serpkite.com/docs/batch.md): Queue up to 100 requests per call with POST /v1/batches at half the credits. Poll GET /v1/batches/{id}, wait with the SDKs, or receive a signed webhook.
- [Webhooks](https://serpkite.com/docs/webhooks.md): Receive finished batch jobs from POST /v1/batches as signed HTTP POSTs. Payload format, headers, HMAC-SHA256 signature verification in Node.js, Python, Go and PHP, and the retry schedule.
- [Page content](https://serpkite.com/docs/include-content.md): Fetch the top search results as clean Markdown in the same /v1/search call with include_content. One request instead of a search plus N page fetches, +1 credit per page.

## Docs: Endpoints

- [Google Search](https://serpkite.com/docs/endpoints/search.md): Organic results, knowledge graph, answer box, People Also Ask, related searches, top stories and sitelinks.
- [Google News](https://serpkite.com/docs/endpoints/news.md): News articles with source, publish date, snippet and thumbnail.
- [Google Images](https://serpkite.com/docs/endpoints/images.md): Image results with source page, dimensions, thumbnail and original URL.
- [Google Videos](https://serpkite.com/docs/endpoints/videos.md): Video results with channel, duration, date and thumbnail.
- [Google Maps](https://serpkite.com/docs/endpoints/maps.md): Local businesses with place_id, rating, review count, coordinates, hours, phone and website.
- [Google Places](https://serpkite.com/docs/endpoints/places.md): Local pack results from the Places tab: name, address, rating, category, CID.
- [Google Reviews](https://serpkite.com/docs/endpoints/reviews.md): Reviews for a place (by place_id, cid or fid), 10 per credit, sortable by newest or rating. Page with next_page_token.
- [Google Shopping](https://serpkite.com/docs/endpoints/shopping.md): Products with price, merchant, rating, review count and delivery info.
- [Google Scholar](https://serpkite.com/docs/endpoints/scholar.md): Papers with authors, publication, year, citation count and PDF links.
- [Google Patents](https://serpkite.com/docs/endpoints/patents.md): Patents with number, assignee, inventor, priority and publication dates, PDF.
- [Google Autocomplete](https://serpkite.com/docs/endpoints/autocomplete.md): Query suggestions as the user types. Useful for keyword research and query expansion.
- [Google Lens](https://serpkite.com/docs/endpoints/lens.md): Visual matches and related products for an image URL.
- [Webpage to Markdown](https://serpkite.com/docs/endpoints/webpage.md): Fetch any public URL and get clean Markdown plus title, description and metadata.
- [Custom Search (CSE-compatible)](https://serpkite.com/docs/endpoints/customsearch.md): For apps moving off the Google Custom Search JSON API: same query params (key, cx, q, start, num…), same items[] and searchInformation shape.
- [Rank](https://serpkite.com/docs/endpoints/rank.md): Where does a domain rank for a keyword? Returns the best organic position in the top N and every matching result.
- [Batches](https://serpkite.com/docs/endpoints/batches.md): Queue up to 100 requests for one endpoint at half price, then poll GET /v1/batches/{id} or get a signed webhook.
- [Account](https://serpkite.com/docs/endpoints/account.md): Balance, rate limit, plan and this month's usage for the account behind the calling key.
- [Status](https://serpkite.com/docs/endpoints/status.md): Public live status: request volume, success rate and p50/p95 latency per endpoint over the last hour.

## Docs: Guides

- [Web search for agents with tool calling](https://serpkite.com/docs/guides/agents-tool-calling.md): Give an OpenAI or Anthropic model live Google search by defining a web_search tool backed by SerpKite. Copy-paste tool schemas, full agent loops in Python and TypeScript, and tips to keep token and credit costs down.
- [Build a RAG pipeline on live search](https://serpkite.com/docs/guides/rag-pipeline.md): Answer questions from the live web. Search Google with SerpKite, get the top pages as clean Markdown in the same call, chunk and rank them, and have an LLM answer with citations. Python and TypeScript code, plus the credit math.
- [Rank tracking](https://serpkite.com/docs/guides/rank-tracking.md): Track where a domain ranks in Google's top 100 for many keywords, by country, city and device. Uses POST /v1/rank, the num=100 depth bundle (7 credits), POST /v1/batches at half price, and signed webhooks.
- [Migrate from Google Custom Search](https://serpkite.com/docs/guides/migrate-from-google-cse.md): Google shuts down the Custom Search JSON API on January 1, 2027. SerpKite's GET /customsearch/v1 takes the same parameters and returns the same response shape, so you change the host and the key and keep your parser.

## Docs: Tools and SDKs

- [MCP server](https://serpkite.com/docs/mcp.md): Give Claude, Cursor, VS Code, ChatGPT or any MCP client live Google search through SerpKite's remote MCP server at https://api.serpkite.com/v1/mcp. One URL, your API key, eleven tools.
- [Official SDKs](https://serpkite.com/docs/sdks.md): Official SerpKite SDKs for TypeScript, Python (sync and async) and Go, plus native LangChain and CrewAI packages. Install, quickstart, options, errors and batches for each.
- [OpenAPI spec](https://serpkite.com/docs/openapi.md): The SerpKite SERP API is described by an OpenAPI 3.1 document. Download it to generate typed clients, import the API into Postman, Insomnia or Bruno, or give it to an LLM.
- [API changelog](https://serpkite.com/docs/changelog.md): Changes to the SerpKite API contract, newest first. Additive changes ship without notice; anything breaking is announced here in advance.

## Docs: Account and dashboard

- [API keys](https://serpkite.com/docs/api-keys.md): Create as many SerpKite API keys as you need, give each a monthly credit limit, and rotate or revoke them without downtime. Keys are stored as hashes and shown only once.
- [Spend controls](https://serpkite.com/docs/spend-controls.md): Cap what your account spends per month, get emailed before the balance runs out or the cap is near, and get a one-click checkout link when it's time to top up.
- [Team](https://serpkite.com/docs/team.md): Invite teammates to your SerpKite account so they can manage keys, watch usage and buy credits on one shared balance, while the owner keeps control of settings and the account.
- [Privacy and data retention](https://serpkite.com/docs/privacy-and-data-retention.md): SerpKite never logs your query text. Results are cached for a few hours under a hashed key, and usage records hold metadata only for 31 days. Here is exactly what is kept, where and for how long.

## SDKs

- [TypeScript: serpkite on npm](https://github.com/serpkite/serpkite-js): `npm install serpkite`, zero dependencies, Node 18+, Bun, Deno and edge.
- [Python: serpkite on PyPI](https://github.com/serpkite/serpkite-python): `pip install serpkite`, `SerpKite` and `AsyncSerpKite`.
- [Go module](https://github.com/serpkite/serpkite-go): `go get github.com/serpkite/serpkite-go`.
- [LangChain: langchain-serpkite](https://github.com/serpkite/langchain-serpkite): search tools, retriever and webpage loader.
- [CrewAI: serpkite[crewai]](https://github.com/serpkite/serpkite-python): `SerpKiteSearchTool`.

## APIs

- [Google Search API](https://serpkite.com/apis/google-search-api)
- [Google News API](https://serpkite.com/apis/google-news-api)
- [Google Images API](https://serpkite.com/apis/google-images-api)
- [Google Videos API](https://serpkite.com/apis/google-videos-api)
- [Google Maps API](https://serpkite.com/apis/google-maps-api)
- [Google Places API](https://serpkite.com/apis/google-places-api)
- [Google Reviews API](https://serpkite.com/apis/google-reviews-api)
- [Google Shopping API](https://serpkite.com/apis/google-shopping-api)
- [Google Scholar API](https://serpkite.com/apis/google-scholar-api)
- [Google Patents API](https://serpkite.com/apis/google-patents-api)
- [Google Autocomplete API](https://serpkite.com/apis/google-autocomplete-api)
- [Google Lens API](https://serpkite.com/apis/google-lens-api)
- [Webpage to Markdown API](https://serpkite.com/apis/webpage-to-markdown-api)
- [Custom Search JSON API](https://serpkite.com/apis/google-custom-search-api)
- [Rank Tracker API](https://serpkite.com/apis/google-rank-tracker-api)

## Integrations

- [MCP (Claude, Cursor, ChatGPT)](https://serpkite.com/integrations/mcp)
- [LangChain](https://serpkite.com/integrations/langchain)
- [LangGraph](https://serpkite.com/integrations/langgraph)
- [CrewAI](https://serpkite.com/integrations/crewai)
- [LlamaIndex](https://serpkite.com/integrations/llamaindex)
- [Vercel AI SDK](https://serpkite.com/integrations/vercel-ai-sdk)
- [Mastra](https://serpkite.com/integrations/mastra)
- [OpenAI Agents SDK](https://serpkite.com/integrations/openai-agents-sdk)
- [Pydantic AI](https://serpkite.com/integrations/pydantic-ai)
- [n8n](https://serpkite.com/integrations/n8n)
- [Make](https://serpkite.com/integrations/make)
- [Zapier](https://serpkite.com/integrations/zapier)
- [Dify](https://serpkite.com/integrations/dify)
- [Flowise](https://serpkite.com/integrations/flowise)
- [Python](https://serpkite.com/integrations/python)
- [Node.js / TypeScript](https://serpkite.com/integrations/node)
- [Go](https://serpkite.com/integrations/go)

## Migration guides

- [From Google Custom Search API](https://serpkite.com/migrate/google-custom-search-api)
- [From Bing Search API](https://serpkite.com/migrate/bing-search-api)
- [From SerpApi](https://serpkite.com/migrate/serpapi)
- [From Tavily](https://serpkite.com/migrate/tavily)
- [From Brave Search API](https://serpkite.com/migrate/brave-search-api)

## Tools

- [SERP checker](https://serpkite.com/tools/serp-checker): See the live Google results for any query and country.
- [Rank checker](https://serpkite.com/tools/rank-checker): Find where a domain ranks in the top 100 for a keyword.
- [SERP token counter](https://serpkite.com/tools/serp-token-counter): Compare the LLM token cost of JSON, compact and Markdown SERPs.
- [CSE migration helper](https://serpkite.com/tools/cse-migration): Paste a Custom Search API URL, get the SerpKite equivalent.

## Comparisons

- [SerpKite vs Serper](https://serpkite.com/compare/serpkite-vs-serper)
- [SerpKite vs SerpApi](https://serpkite.com/compare/serpkite-vs-serpapi)
- [SerpKite vs Tavily](https://serpkite.com/compare/serpkite-vs-tavily)
- [SerpKite vs DataForSEO](https://serpkite.com/compare/serpkite-vs-dataforseo)
- [SerpKite vs Scrapingdog](https://serpkite.com/compare/serpkite-vs-scrapingdog)
- [SerpKite vs SearchApi](https://serpkite.com/compare/serpkite-vs-searchapi)
- [SerpKite vs Brave Search API](https://serpkite.com/compare/serpkite-vs-brave-search-api)
- [SerpKite vs Exa](https://serpkite.com/compare/serpkite-vs-exa)
- [Serper alternatives](https://serpkite.com/compare/serper-alternatives)
- [SerpApi alternatives](https://serpkite.com/compare/serpapi-alternatives)
- [Best SERP APIs in 2026](https://serpkite.com/compare/best-serp-api)

## Optional

- [Pricing](https://serpkite.com/pricing)
- [Playground](https://serpkite.com/playground)
- [Blog](https://serpkite.com/blog)
- [How we collect data](https://serpkite.com/legal/how-we-collect)
- [Terms of Service](https://serpkite.com/legal/terms)
- [Refund Policy](https://serpkite.com/legal/refunds)
- [Privacy Policy](https://serpkite.com/legal/privacy)