{"uid":"cap_f5fb9NYlfyT-DWJCUM2YI","slug":"worlddata402-geocoding-c8b654bf","name":"WorldData402 Geocoding","description":"Global market, government and reference data for AI agents. Pay-per-call over x402 (USDC on Base mainnet).","url":"https://worlddata402.worlddata402.workers.dev/v1/geocode?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qDXI3y9bajtrxbDtD-31j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a free-text location query string into structured geographic coordinates and metadata","exampleAgentPrompt":"Can you geocode 'Paris, France' and give me its latitude and longitude coordinates?","exampleUseCases":[{"title":"Enriching user addresses with coordinates","prompt":"I have a list of business addresses and I need their latitude and longitude — can you geocode '1600 Amphitheatre Parkway, Mountain View, CA' to start?"},{"title":"Mapping campaign locations by city name","prompt":"We're plotting our sales regions on a map — can you get me the coordinates for 'Lagos, Nigeria' so I can pin it?"},{"title":"Resolving country capital for routing logic","prompt":"What are the geographic coordinates of 'Canberra, Australia'? I need to use them to set up a proximity-based routing rule."}],"resultDescription":"A JSON object containing structured geographic information for the queried location, including latitude, longitude, formatted address, and potentially additional place metadata such as country, region, and bounding box.","failureModes":["Ambiguous query with multiple matching places may return unexpected results or the first best match","Unrecognized or misspelled place names may return empty results or an error","Missing required 'q' parameter returns a 400-level error","Payment failure over x402 protocol returns a 402 Payment Required response","Rate limits or service unavailability may cause 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need lightweight, pay-per-call geocoding without a subscription, especially in agent workflows that already use x402 USDC micropayments on Base mainnet. It is a good fit when you need to enrich location strings with coordinates on demand, and you want to avoid committing to a monthly geocoding plan. Prefer alternatives like Google Maps or Mapbox Geocoding API if you need batch geocoding, high-volume throughput, or autocomplete suggestions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T18:43:22.093Z","isFirstParty":false,"canonicalSlug":"worlddata402-geocoding-c8b654bf"}