{"uid":"cap_s7RFIcWaEhRvo5bXgkxQO","slug":"beggar-bot-geocode-api-8affddd6","name":"Beggar Bot Geocode API","description":"Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.","url":"https://beggar-bot-demand.beggarbot.workers.dev/v1/geocode?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"address or place"},"lat":{"type":"string","description":"latitude (reverse)"},"lon":{"type":"string","description":"longitude (reverse)"},"limit":{"type":"string","description":"1-10"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6Zkg4sc7_4DxSZBVCkYlk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts addresses or place names to geographic coordinates (forward geocoding) or converts lat/lon to addresses (reverse geocoding)","exampleAgentPrompt":"Can you geocode '1600 Pennsylvania Avenue NW, Washington, DC' and give me the latitude and longitude?","exampleUseCases":[{"title":"Forward geocode a street address","prompt":"What are the GPS coordinates for '221B Baker Street, London'? I need the latitude and longitude."},{"title":"Reverse geocode GPS coordinates","prompt":"I have coordinates lat 48.8584 and lon 2.2945 — can you tell me what address or place that corresponds to?"},{"title":"Find coordinates for a landmark","prompt":"Look up the coordinates for the Eiffel Tower and return up to 3 matching results so I can pick the right one."}],"resultDescription":"A JSON response containing one or more geocoded results, each with coordinates (latitude/longitude), formatted address, and place metadata such as name, country, and bounding box.","failureModes":["Missing required query parameter (q, lat, or lon) returns an error","Invalid or unrecognizable address string returns empty results","Coordinates outside valid range may return no results","Rate limiting or payment failure via x402 may block the request","Network errors from the Cloudflare Workers runtime"],"whenToPreferThis":"Use this endpoint when you need quick, pay-per-call geocoding without a subscription, particularly in agent workflows that already use the x402 micropayment protocol on Base mainnet. It is well-suited for lightweight or infrequent geocoding tasks where spinning up a full geocoding API key is overkill.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T12:20:46.079Z","isFirstParty":false,"canonicalSlug":"beggar-bot-geocode-api-8affddd6"}