Serper Google Search API
Official OpenAPI specification for the Serper.dev Google Search API (`google.serper.dev`). Serper provides low-latency, structured JSON access to real-time Google Search data, optimized for AI agents, LLMs, and RAG pipelines. **Key Features:** - Fast response times (~1-2s) with clean, structured JSON schemas. - Full coverage across Google Web, Images, News, Places (Maps), Videos, and Shopping. - Enriched search data including Knowledge Graph, Answer Boxes, People Also Ask, and Related Searches. - Global localization via country (`gl`) and language (`hl`) parameters.
Connect this API to an AI agent Browse all specs
What you can do with Serper Google Search API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| POST | /search |
searchGoogle | Google Web Search |
| POST | /images |
searchImages | Google Image Search |
| POST | /news |
searchNews | Google News Search |
| POST | /places |
searchPlaces | Google Places & Maps Search |
| POST | /videos |
searchVideos | Google Videos Search |
| POST | /shopping |
searchShopping | Google Shopping Search |
Authentication
ApiKeyAuth
API key — sent as the X-API-KEY header
Serper API key provided via the X-API-KEY header.
Usage guide
Serper Google Search API Usage Guide for AI Agents
Authentication
Send your Serper API key in the X-API-KEY header for every request:
X-API-KEY: YOUR_SERPER_API_KEY
Content-Type: application/json
Get an API key with 2,500 free queries (no credit card required) at https://serper.dev.
1. Google Web Search (POST /search)
Executes a standard Google search returning organic listings, knowledge graph, and answer box.
POST https://google.serper.dev/search
X-API-KEY: YOUR_SERPER_API_KEY
Content-Type: application/json
{
"q": "Apple Inc stock news",
"gl": "us",
"hl": "en",
"num": 10
}
2. Google News Search (POST /news)
Fetch breaking and topical news articles.
POST https://google.serper.dev/news
X-API-KEY: YOUR_SERPER_API_KEY
Content-Type: application/json
{
"q": "autonomous AI agents",
"gl": "us",
"hl": "en"
}
3. Google Images Search (POST /images)
Retrieve direct image links, thumbnails, and origin websites.
POST https://google.serper.dev/images
X-API-KEY: YOUR_SERPER_API_KEY
Content-Type: application/json
{
"q": "modern minimalist architecture"
}
4. Google Places / Maps Search (POST /places)
Find local businesses, addresses, ratings, and phone numbers.
POST https://google.serper.dev/places
X-API-KEY: YOUR_SERPER_API_KEY
Content-Type: application/json
{
"q": "coffee shops in San Francisco",
"gl": "us"
}
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Serper Google Search API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.