# Local Web Search by Country/City

> Local Web Search by Country/City is a paid API for AI agents from agent-search.centorprat.workers.dev, paid per call via x402, $0.012/call, status unknown (last checked 2026-10-30).

Returns Google search results as seen by a user in a specific country, language, and city, including local map pack businesses, top stories, and per-result domain metadata.

## Facts

- Endpoint: POST https://agent-search.centorprat.workers.dev/geo-search?utm_source=zero.xyz
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/local-web-search-by-country-city-1fc48785
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__Hac2dk0WnM0zlEFqLU5f

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 local-web-search-by-country-city-1fc48785 -d '<json body>'
```

Example prompt: Search Google for 'best coffee shops' as if I'm in Madrid, Spain, in Spanish, and give me the top 5 results including any local map pack businesses with their ratings and phone numbers.

## When to prefer this

Choose this endpoint when you need search results localized to a specific country, language, or city — especially when you need the local Google map pack with business details, or when doing geo-targeted SEO research, travel planning, or price comparisons across markets. Prefer over generic web search endpoints when geographic localization of results is critical and you don't want to use a VPN.

## Known failure modes

- Invalid country code returns an error or defaults to US
- Unsupported language code may fall back to default or return empty results
- City/region not recognized may result in no map pack or inaccurate localization
- numResults out of range (below 1 or above 10) returns a validation error
- Query string is empty or missing — required field error
- Payment not included or insufficient — 402 Payment Required

## How this service works

Search from anywhere without a VPN: Google results exactly as a searcher in a given country, language and city sees them, with the local map pack (businesses with rating, phone, website), top stories, and per result the domain authority, type and whether it is a local domain. For local research, travel, prices, SEO and geo-restricted content.

## Output

A structured response containing organic search results (title, URL, snippet, domain authority, domain type, local domain flag), a local map pack with business names, ratings, phone numbers, and websites, top news stories relevant to the query, and metadata about the geo-targeted search context.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "time": {
   "type": "string",
   "description": "freshness: hour, day, week, month or year (optional)"
  },
  "query": {
   "type": "string",
   "description": "What to search for"
  },
  "country": {
   "type": "string",
   "description": "2-letter country the results are for: us, gb, de, es, fr, in, br, ... (default us)"
  },
  "private": {
   "type": "boolean",
   "description": "true = the query is not logged or cached (default false)"
  },
  "language": {
   "type": "string",
   "description": "e.g. es, de, ja"
  },
  "location": {
   "type": "string",
   "description": "city / region, e.g. Madrid, Spain"
  },
  "numResults": {
   "type": "integer",
   "description": "1-10"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/local-web-search-by-country-city-1fc48785/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-search.centorprat.workers.dev](https://www.zero.xyz/host/agent-search.centorprat.workers.dev/llms.txt)