Google Search reference
Google Search API guide
Choose web, news, image or map search for the type of result you need. A search snippet is a discovery record; retrieve its source page when the full text matters.
Quickstart
Start with Google Search
Choose web, news, image or map search for the type of result you need. A search snippet is a discovery record; retrieve its source page when the full text matters.
These requests use your API key and can spend credits. Check the current price on the endpoint page; each new page is a separate request. Later examples use illustrative identifiers: replace them with values from your earlier response.
1. Find web pages
Save result URLs and rankings with the query and location. Parameters and current cost →
curl "https://www.monocrawl.com/v1/google_search/search?query=developer%20tools&location=London%2CEngland%2CUnited%20Kingdom&language=en&limit=10" \ -H "x-api-key: mn_your_key_here"
2. Compare news coverage
This is a separate news search, not a continuation of the web results. Parameters and current cost →
curl "https://www.monocrawl.com/v1/google_search/news?query=developer%20tools&location=United%20Kingdom&language=en&limit=10" \ -H "x-api-key: mn_your_key_here"
3. Find relevant places
This is a location-oriented search. Searches of up to 20 results use Google local search first in the UK and US (English), or Germany (German), with an alternative Maps source if the first source fails or returns incomplete data. Other countries, languages and larger searches use the Maps source directly. Local results retain place IDs, addresses, ratings and coordinates, but ranking may differ and hotel ratings/price levels are null; the response includes a note. Allow at least 75 seconds for standalone calls: local search gets up to 15 seconds, followed by up to 50 seconds for recovery within the shared deadline. Earlier batch deadlines still apply. A successful request costs four credits once; a failed request is refunded. Use the Places platform for a known place ID’s detail or reviews. Parameters and current cost →
curl "https://www.monocrawl.com/v1/google_search/maps?query=software%20companies%20in%20London&location=London%2CEngland%2CUnited%20Kingdom&language=en&limit=10" \ -H "x-api-key: mn_your_key_here"
Filters and coverage
Choose filters with the source behavior in mind
| Control | Behavior and limits |
|---|---|
| Regional meaning | location and language influence search context. They do not establish where a page author lives. The documented default search location is the United Kingdom. Endpoint reference → |
| Ranking | device applies to web search; do not assume the news or maps route supports it. Retain query and ranking context with saved results. Endpoint reference → |
| Depth and follow-up | These operations expose limit rather than a public cursor. Do not invent a page or date-range parameter. Fetch the source page when a snippet is insufficient. Endpoint reference → |
Source availability, ordering and field coverage can change. Inspect warnings and partial-result metadata alongside the rows. See runnable workflows, metric semantics, computed fields and the pagination matrix.
Choose an endpoint
Match the operation to your task
| Your task | Endpoint | When to use it |
|---|---|---|
| General web discovery | search | Supports desktop/mobile ranking context. |
| Recent news discovery | news | News results are a different corpus, not guaranteed exhaustive coverage. |
| Image discovery | images | Image results do not grant rights to reuse source media. |
Explore all documented operations by purpose below. Each endpoint reference contains its accepted parameters and current price.
Search and discovery
Operations
Google Search
Each row is a registry operation: expand it for parameters, a curl built from the registry's own examples, and a Markdown copy of the whole entry. The badge on the right is the operation's state, read at request time — we publish all three rather than rounding up. Recorded proof is historical, not a guarantee of current availability.
- live · proven
- a real upstream response has been served through this API and recorded
- wired · unproven
- a real-data route is registered, but qualifying proof is absent; permission or capacity restrictions may apply
- sample · free
- no live upstream — /v1 refuses it, /sandbox returns a marked sample
Google Search
4 operationsElsewhere
The same registry, other shapes
- Google Search overview — supported data categories and use cases for this platform.
- Full endpoint reference — every platform on one page.
/openapi.jsonor/openapi.yaml— the machine-readable contract, for Postman, Insomnia or a client generator.GET /v1/utility/endpoints?platform=google_search— the same rows to your code at runtime, for 0 credits.