# FastAF Google Maps Places Search

> FastAF Google Maps Places Search is a paid API for AI agents from api.fastaf.co, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-28).

Returns Google Maps places as structured JSON (name, address, rating, review count, place_id) for a search query, or detailed info for a single place by place_id.

## Facts

- Endpoint: GET https://api.fastaf.co/x402/v1/maps?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fastaf-google-maps-places-search-b5206cb3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m6CifwOCLGSpp3drxylEn

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 fastaf-google-maps-places-search-b5206cb3
```

Example prompt: Can you search Google Maps for the top-rated Italian restaurants in Rome and give me a list with their names, addresses, ratings, and review counts?

## When to prefer this

Use this endpoint when you need structured Google Maps place data (name, address, rating, review count, place_id) returned as JSON, especially for search queries centered on a named location or when resolving a known place_id. Prefer this over general web scraping when you specifically need Google Maps place metadata in a machine-readable format without parsing HTML.

## Known failure modes

- Missing both 'query' and 'place_id' parameters returns a validation error
- Invalid place_id returns empty or null result
- Unsupported Google domain value may cause no results
- Pagination with page > 100 is out of range
- Network or upstream Google Maps unavailability causes request failure (not billed)
- Invalid ll coordinate format causes search center inference failure

## How this service works

Local business and places search API for AI agents: Google Maps results as JSON with addresses, ratings, review counts, coordinates and place IDs when available. Supports searches by query and location or place details by place_id. Provided by FastAF Google Maps & Places. Price: $0.005000 USDC per successful call.

## Output

A JSON object containing an array of search results, each with: title (place name), address, rating (float), reviews (integer count), and place_id (Google Maps unique identifier). When querying by place_id, returns a single place detail object with the same fields.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "FastAF Google Maps & Places",
 "$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",
     "anyOf": [
      {
       "required": [
        "query"
       ]
      },
      {
       "required": [
        "place_id"
       ]
      }
     ],
     "examples": [
      {
       "ll": "@40.758,-73.9855,14z",
       "query": "coffee near Times Square",
       "language": "en"
      }
     ],
     "properties": {
      "ll": {
       "type": "string",
       "examples": [
        "@40.758,-73.9855,14z"
       ],
       "maxLength": 8192,
       "description": "Search centre as @latitude,longitude,zoom, e.g. @41.9028,12.4964,13z (coordinates in degrees; zoom 3z-30z; map height in metres also supported upstream). Needed for pagination. Cannot combine with location; omitted: infer from query/location. No option surcharge; 5 credits per successful request."
      },
      "data": {
       "type": "string",
       "maxLength": 8192,
       "description": "Opaque data fragment copied from a Google Maps URL, e.g. !4m5!3m4!1s<id>!8m2!3d<lat>!4d<lon>. Used with type=place; unnecessary with place_id. No default. No option surcharge; 5 credits per successful request."
      },
      "page": {
       "type": "integer",
       "minimum": 0,
       "description": "Maps result offset, integer 0-100: 0 first page, 20 second, 40 third. Default 0; supply ll for pagination. Each page is a separate request. No option surcharge; 5 credits per successful request."
      },
      "type": {
       "enum": [
        "search",
        "place"
       ],
       "type": "string",
       "description": "Maps operation: search for query results or place for details using data. Omit for query search or automatic place_id lookup. No option surcharge; 5 credits per successful request."
      },
      "query": {
       "type": "string",
       "examples": [
        "coffee near Times Square"
       ],
       "maxLength": 8192,
       "description": "Maps search text, e.g. coffee in Rome; required unless place_id is supplied. Without location or ll, FastAF uses a place named in the query. No option surcharge; 5 credits per successful re
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "search_results": [
   {
    "title": "Example Cafe",
    "rating": 4.6,
    "address": "...",
    "reviews": 1200,
    "place_id": "ChIJ..."
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fastaf-google-maps-places-search-b5206cb3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fastaf.co](https://www.zero.xyz/host/api.fastaf.co/llms.txt)