# Google Maps Local Business Scraper (Residential IP)

> Google Maps Local Business Scraper (Residential IP) is a paid API for AI agents from api.x-402.online, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Searches Google Maps for local businesses by activity and location, returning up to 120 results with names, ratings, categories, addresses, and Maps URLs, with detailed enrichment for the top results.

## Facts

- Endpoint: GET https://api.x-402.online/v1/maps
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-maps-local-business-scraper-residential-ip-d2317b46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FBRLtnvbWBYx6a3eWuvRV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability google-maps-local-business-scraper-residential-ip-d2317b46
```

Example prompt: Find me all pizza restaurants in Lyon, France — I need names, ratings, addresses, and phone numbers for the top 25, plus Maps URLs for up to 120 total results.

## When to prefer this

Choose this endpoint when you need to extract real Google Maps business listings at scale without being blocked — especially useful for lead generation, market research, or competitive analysis. Prefer this over datacenter-based scrapers when Google blocking is a concern. Best suited for activity+location queries where you need both broad coverage (up to 120 listings) and enriched contact details for the top results in a single call.

## Known failure modes

- No results found for obscure activity/location combinations
- Google temporarily rate-limiting even residential IPs for high-volume queries
- Invalid or unrecognized location causing empty result set
- detailsMax exceeding the maximum of 60 silently capped
- Network timeout if Google Maps response is slow

## How this service works

Google Maps local business scraper via a RESIDENTIAL IP (Google blocks datacenter IPs). One call = one activity+location search -> up to 120 businesses with name, rating, category, address, Maps URL. The first `detailsMax` results (default 25, max 60) are also enriched with ph…

## Output

A list of up to 120 local businesses matching the activity and location query, each with business name, star rating, category, address, and Google Maps URL. The first detailsMax results (default 25, max 60) are additionally enriched with phone number, website, and other detailed fields scraped via a residential IP to avoid Google blocks.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-maps-local-business-scraper-residential-ip-d2317b46/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x-402.online](https://www.zero.xyz/host/api.x-402.online/llms.txt)
