# AdFreeLLM Maps Search API

> AdFreeLLM Maps Search API is a paid API for AI agents from speecship.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Search for local businesses and places by category and location, returning names, addresses, and categories via pay-per-call Google Maps-backed lookup.

## Facts

- Endpoint: POST https://speecship.com/relay/1787408857149/maps/search
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adfreellm-maps-search-api-acf44ab5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fBSrKs7dW99PY3hpPnJ8d

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 adfreellm-maps-search-api-acf44ab5 -d '<json body>'
```

Example prompt: Find me up to 10 coffee shops in downtown Portland, Oregon and return their names and addresses.

## When to prefer this

Choose this endpoint when you need structured local business listings (name, address, category) for a specific place type and city without requiring a subscription or API key — ideal for AI agents making occasional, pay-per-use map searches billed in USDC via x402.

## Known failure modes

- Empty results if no businesses match the query or location combination
- Invalid location string causing no results or geocoding failure
- Query too vague or too long (over 300 chars) returning unexpected results
- Limit exceeding maximum of 10 being clamped or rejected
- Payment failure via x402 if insufficient USDC balance, blocking the request

## How this service works

Agent-ready Google Search, web crawling, Maps, social, and App Store review research APIs. Pay per request in USDC over x402—no subscription or API key required.

## Output

A JSON array of place objects, each containing a title (business name), address (street address), and categoryName (business type/category), up to the requested limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 10,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1,
   "description": "Business category or search phrase"
  },
  "language": {
   "type": "string",
   "default": "en",
   "maxLength": 8,
   "minLength": 2
  },
  "location": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1,
   "description": "City, region, or address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "title": "Example Coffee",
   "address": "123 Main St",
   "categoryName": "Coffee shop"
  }
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adfreellm-maps-search-api-acf44ab5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from speecship.com](https://www.zero.xyz/host/speecship.com/llms.txt)