HTTP/1.1 402 PAYMENT REQUIRED agent402.base.eth · BASE · SOLANA · POLYGON · ARBITRUM · MONAD · CELO · AVALANCHE · SEI · OPTIMISM · STELLAR · ALGORAND · ROBINHOOD · USDC · USDG
Agent402 / tools / place-search

Place search

$0.003 per call · USDC via x402 · GET /api/place-search · Cached 1h

Search OpenStreetMap for places by keyword, optionally restricted to a bounding box or country. Returns ranked hits with coordinates and place type - e.g. coffee shops in a city, airports in a region. ?q=coffee&viewbox=-122.52,37.81,-122.35,37.70&bounded=1.

Input

FieldTypeDescription
q *stringFree-form place query
limitnumberResults to return, 1-20 (default 5)
countryCodesstringComma-separated ISO-3166-1 alpha-2 codes (optional)
viewboxstringBounding box as 'west,north,east,south' (lon/lat). Optional.
boundedstringIf '1' and viewbox set, restrict strictly to box (default 0)

Example output

{
  "query": "Eiffel Tower",
  "count": 1,
  "results": [
    {
      "displayName": "Eiffel Tower, 5, Avenue Anatole France, Quartier du Gros-Caillou, Paris 7e Arrondissement, Paris, …, France",
      "lat": 48.8582599,
      "lon": 2.2945006,
      "type": "attraction",
      "class": "tourism",
      "importance": 0.84,
      "osm": "way/5013364",
      "boundingBox": {
        "south": 48.8574753,
        "north": 48.8590453,
        "west": 2.2933342,
        "east": 2.2956671
      }
    }
  ],
  "source": "nominatim.openstreetmap.org (ODbL)"
}

Try it - see the 402 challenge (free)

curl -i "https://agent402.tools/api/place-search?q=Eiffel+Tower&limit=3"

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/place-search?q=Eiffel+Tower&limit=3");
Wallet-only. This tool reaches the network/browser/storage, so it is paid in USDC via x402 (no proof-of-work tier).

Part of these workflows

This tool is one step in a curated multi-tool workflow - agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.

Related tools

US gov dataset search

$0.003 · GET /api/gov-data

Search 300,000+ US government datasets on catalog.data.gov (CKAN): titles, publishing org, formats, and direct resource …

US weather alerts

$0.003 · GET /api/weather-alerts

Active National Weather Service alerts for a US state as clean JSON: event, severity, headline, affected areas, onset/ex…

Recent earthquakes (USGS)

$0.003 · GET /api/earthquakes

Real-time USGS earthquake feed: magnitude, place, time, depth, coordinates. Live government data, no key. ?minMag=4.5&pe…