Signaloutscraper · maps search
Outscraper: Google Maps search. GET /google-maps-search accepts your x-api-key header. Costs credits that scale with the request (see parameters) per successful fresh call; failures and opt-in cache hits (cache_max_age) are free. Native path: GET /api/v1/web/outscraper/maps-search. Same request parameters and JSON shape as the reference API, so you can switch by changing the base URL.
Request parameters
Places from Google Maps for each query; place_id / google_id / CID / Maps URL queries return that place. Outscraper-compatible (/google-maps-search); served by google-maps/search (place ids/URLs: google-maps/place). Billed per query at the underlying op's price.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Query, or several queries as repeated `query` params (max 10 per call; each query is billed separately). |
async | string | No | Outscraper async flag. Accepted and ignored: results are always returned synchronously with status "Success". |
ui | string | No | Accepted and ignored. |
webhook | string | No | Callback URL. Accepted and ignored: results are always returned synchronously. |
fields | string | No | Comma-separated field list. Accepted and ignored: all fields are returned. Accepted and ignored: results are always returned synchronously. |
format | string | No | Output file format (UI tasks). Accepted and ignored: results are always returned synchronously. |
limit | string | No | Places per query (default 20, max 100 here). |
organizationsPerQueryLimit | string | No | SDK alias of limit. |
skipPlaces | string | No | Skip first N places (multiple of 20). |
skip | string | No | Alias of skipPlaces. |
dropDuplicates | string | No | Drop the same place across queries. |
totalLimit | string | No | Total places across all queries. |
coordinates | string | No | Accepted and ignored (put the location in the query). |
filters | string | No | Quick filters. Accepted and ignored: results are always returned synchronously. |
enrichment | string | No | Enrichments (not offered). Accepted and ignored: results are always returned synchronously. |
language | string | No | Language code (default en). |
region | string | No | Two-letter country code. |
freshness | string | No | 24h (default), 1h, 7d, or live. Accepted cache hits are free; live forces refresh except simultaneous requests may share newly fetched data. |
Code examples
Set SIGNALSHELF_BASE_URL and SIGNALSHELF_API_KEY on your server.
curl "$SIGNALSHELF_BASE_URL/google-maps-search?query=pizza%2C+New+York%2C+NY%2C+USA" \
-H "x-api-key: $SIGNALSHELF_API_KEY"const response = await fetch(process.env.SIGNALSHELF_BASE_URL + "/google-maps-search?query=pizza%2C+New+York%2C+NY%2C+USA", {
headers: { 'x-api-key': process.env.SIGNALSHELF_API_KEY },
});
const body = await response.json();
if (!response.ok) throw new Error(body.error.message);
console.log(body.data, body.meta);import os, requests
response = requests.get(
os.environ['SIGNALSHELF_BASE_URL'] + "/google-maps-search?query=pizza%2C+New+York%2C+NY%2C+USA",
headers={'x-api-key': os.environ['SIGNALSHELF_API_KEY']},
timeout=30,
)
response.raise_for_status()
print(response.json())Response and pagination
The response contains data and meta. data includes platform, resource, sample:false, provider, and the public source payload. Lists return data.items; individual resources return data.data.
Author feeds include data.next_cursor. Return it unchanged in cursor for the next page. Feed entries can include reposts. Single-post lookups resolve the handle to a DID first. Deleted or moderated posts may be unavailable.
meta includes event_id, mode, cache, credits_charged, fetched_at, age_seconds, and duration_ms. A fresh successful result costs one credit; accepted cached results and failures cost zero.
Availability and failures
Implementation is not a continuous availability guarantee. Source rate limits, retention, deleted content, restrictions, and regional availability apply. This is an independent SignalShelf contract, not a drop-in competitor response format.
400: invalid parameters. 401: missing/revoked key. 402: insufficient credits. 404: missing public resource. 429: SignalShelf throttle. 502/503: upstream failure or rate limit, with credit restored.