{"uid":"cap_qu_bKvPjcYYXQFY7A2YGY","slug":"geo402-geocoding-ff24fcc6","name":"geo402 Geocoding","description":"Pay-per-call geolocation utility for AI agents: geocoding, reverse geocoding, timezone lookup, and great-circle distance. No API key, no subscription — agents pay per request via x402 (Base/USDC) or MPP (Tempo/pathUSD).","url":"https://geo402.alogos.xyz/v1/geocode","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Place, city, or region name to geocode, e.g. 'Lisbon' or 'New York'."},"limit":{"type":"integer","description":"Maximum ranked matches to return."}}},"responseSchema":{"type":"object","required":["query","results"],"properties":{"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"name":{"type":"string"},"admin1":{"type":"string"},"timezone":{"type":"string"},"distanceKm":{"type":"number","description":"Present on reverse geocoding responses."},"population":{"type":"number"},"countryCode":{"type":"string"},"countryName":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true},"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_QcRvWSQVtUGpZOr0sOZhA","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 a place or city name into geographic coordinates (latitude/longitude) using a pay-per-call model with no API key required","exampleAgentPrompt":"What are the latitude and longitude coordinates for Lisbon? Just give me the top result.","exampleUseCases":null,"resultDescription":"Returns one or more geocoded results for the queried place name, each containing latitude, longitude, and the resolved place name. The `limit` parameter controls how many results are returned.","failureModes":["Place name not found — returns empty results or 404","Ambiguous place name returns unexpected or irrelevant location","Missing required `q` parameter returns 400 Bad Request","Payment not provided or insufficient — returns 402 Payment Required","Rate limiting or service unavailability returns 5xx error"],"whenToPreferThis":"Choose this endpoint when you need forward geocoding (place name to coordinates) without an API key or subscription, especially in agent pipelines that can handle x402 micropayments on Base/USDC or MPP/pathUSD. Ideal for one-off or low-volume lookups where pay-per-call economics are preferable to a monthly plan.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:31:52.748Z","isFirstParty":false}