Location Discovery Setup

✅

Already live and working. AgentPay uses OpenStreetMap (Nominatim + Overpass API) for location search — free, open-source, 190+ countries, 500M+ businesses. No API key setup needed to use search. This guide explains how it works and how to integrate with it.

How Location Search Works LIVE

When an AI agent or user searches for a service, AgentPay runs a two-source lookup:

AgentPay Registry — verified providers with real pricing and booking. Always ranked first.
OpenStreetMap (Overpass API) — global fallback with 500M+ business listings worldwide

Results are blended and ranked: Verified AgentPay providers first, then OSM results sorted by proximity.

AgentPay Verified

Real-time booking
Confirmed pricing
SMS notifications
Guaranteed response

OSM Listings

500M+ businesses
190+ countries
Address + hours
No booking (yet)

Using the Search API

Make a POST request to /api/v1/search with x402 payment ($0.001 USDC on Base mainnet):

# Register an agent first to get your API key

POST /api/v1/search

Authorization: Bearer <your-api-key>

Content-Type: application/json

{

  "query": "plumber near me",

  "location": "Grand Canyon, AZ",

  "category": "plumbing",  // optional

  "radius_km": 25,           // default 25

  "max_results": 10          // default 10

}

Location can be: city + state, zip code, or "lat,lng" coordinates.

Get Your Business Into Search Results

To appear in AgentPay search results as a Verified provider, you have two options:

Register directly — sign up at /register or download the Android app
Claim an OSM listing — if your business is already on OpenStreetMap, claim it via SMS in the app to get Verified

Verified providers always appear before OSM-only results, get real booking capability, and receive SMS + voice notifications for new bookings.

🚀 Register Your Business 📱 Download Android App

For AI Agents — x402 Integration DEVS

AgentPay is listed on Bazaar / agentic.market. AI agents that support x402 can call the search API autonomously:

# Discovery via llms.txt

GET https://www.x402-agent-pay.com/llms.txt

# OpenAPI spec

GET https://www.x402-agent-pay.com/openapi.json

# Register your agent

POST /api/v1/marketplace/register

{ "agent_name": "my-agent", "capabilities": ["search", "book"] }

Questions? Email [email protected] or use the chat bubble on this page.

🗺️ Location Discovery Setup

How Location Search Works LIVE

Using the Search API

Get Your Business Into Search Results

For AI Agents — x402 Integration DEVS

Aria