fetcher.sh
all services

Google Maps data API

Place search, place details, and reviews. No account, no OAuth — pay per call with x402 or spend a prepaid credit balance with one API key.

4 endpoints$0.005 per callGET · JSON envelopeUSDC · gas sponsored
pay from any of:BasePolygonArbitrumMonadSolana

Also covers: gmaps · places · business listings

the main one

start here

$0.005 per call

Place search

/api/place/search

Search by text, or pin the search to a coordinate to get results near a specific point.

try an example

Try it/api/place/search?query=ramen+in+brooklyn

opens the payment page in a new tab · $0.005 per call

quick start

Call Google Maps in 30 seconds

curl — with a credits API key
curl -H 'Authorization: Bearer bby_live_...' \
  'https://google-maps.fetcher.sh/api/place/search?query=coffee+in+brooklyn'
curl — no key: the x402 challenge
# call without payment to inspect the 402 challenge
curl -i 'https://google-maps.fetcher.sh/api/place/search?query=coffee+in+brooklyn'
# HTTP/1.1 402 Payment Required
# payment-required: <base64 payment requirements>

No key yet? Top up once (minimum $1) and the first response contains your bby_live_ key — one balance works across every fetcher.sh service. Generate one.

mcp

Add Google Maps to Claude or Cursor

A remote MCP server scoped to this service: your agent gets these tools and nothing else, so the context cost stays small.

mcp config
{
  "mcpServers": {
    "fetcher": { "url": "https://google-maps.fetcher.sh/mcp" }
  }
}

reference

All 4 Google Maps endpoints

Click any endpoint to open its console: fill the parameters and try it live — the payable URL opens in a new tab, ready for a browser wallet.

docs
docs
docs
docs

Top up once — then hammer all 4 endpoints with one key

One x402 payment funds a credit balance. Every call after that is a plain Bearer request: no signing, no chain round-trip, more requests per second. The same balance works on every fetcher.sh service.

Generate API key your first top-up creates the key — shown once

Agents: paste Set up https://google-maps.fetcher.sh/skill.md into your agent — it reads the skill and sets everything up.