Create an account — it comes with 500 free credits and needs no card. Open API keys in the dashboard and create a key. Keep it private: send it only in the X-API-Key header, never in a URL or in browser code.
API keys →Quickstart
Run your first Google search through the API in about two minutes. You need an API key and a terminal; nothing to install.
Get an API key
Send a search
Search endpoints take a JSON body over POST. This one searches Google for “coffee shops” as someone in the US would:
curl -X POST 'https://api.serpbase.dev/google/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
--max-time 60 \
-d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'Prefer clicking? The same request runs in the Playground, which fills in your key. Playground →
Base URL: https://api.serpbase.dev
Read the result
You get the results page as JSON, one field per block Google showed. A real answer, shortened:
{
"status": 0,
"credits_charged": 1,
"request_id": "r-4b27fe8a36d9ac303a5da7dd",
"product_id": "google_web_search",
"query": "coffee shops",
"local_results": [
{
"address": "Denver, CO",
"category": "Coffee shop",
"hours": "Open",
"position": 1,
"rank": 1,
"rating": "4.9",
"reviews_count": "455",
"title": "Coffeegraph"
},
{
"address": "Sioux Falls, SD",
"category": "Coffee shop",
"hours": "Open",
"position": 1,
"rank": 2,
"rating": "4.9",
"reviews_count": "295",
"title": "The Breaks Coffee Roasting Co."
}
],
"organic": [
{
"date": "Sep 17, 2026",
"display_link": "www.discovertheburgh.com",
"display_url": "www.discovertheburgh.com",
"link": "https://www.discovertheburgh.com/pittsburgh-coffee-shops/",
"position": 3,
"published_at": "Sep 17, 2026",
"rank": 1,
"snippet": "🏨 Book Avenue in Garfield. Redhawk Coffee. Ghost Coffee Collab at Trace Brewing. Kaibur Coffee Kaibu…",
"source_url": "https://www.google.com/goto?url=CAESdAHrOzAVQPT8-1-RxOq_G62WuAgUAmaFDk4SD6YsadPoLMH5lbvuR0WPu8BR2EKN…",
"title": "48 Pittsburgh Coffee Shops to Grab a Delicious Brew",
"url": "https://www.discovertheburgh.com/pittsburgh-coffee-shops/"
}
],
"page": 1,
"people_also_ask": [
{
"position": 2,
"question": "What are the top 10 coffee chains?"
},
{
"position": 2,
"question": "What are the main coffee shop chains?"
}
],
"people_also_search_for": [
"Best coffee shops",
"Coffee shops Orlando"
],
"related_searches": [
"Best coffee shops in Pittsburgh to study",
"Coffee Shops near Monroeville PA"
],
"search_type": "search"
}- status: 0
- Success. Anything else comes with an error message, and a failed search costs nothing.
- credits_charged
- What this request cost. A Google search is 1 credit.
- request_id
- Quote it when you contact support; we find the request in seconds.
Where to next
Every parameter and result field: AI Overviews, local pack, People also ask and more.
Billing →What each request costs, and why failed requests are free.
Responses & errors →Each error code, whether it was charged and whether to retry.
MCP & AI agents →MCP server for Claude, Cursor, Codex and others, with your key.