{"uid":"cap_qJczNPKiXFLcsj0uogiiQ","slug":"geo402-geocoding-forward-fb67cd89","name":"geo402 Geocoding (Forward)","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://69.67.172.228.sslip.io/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":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/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_B8_YF72BVgsTjRD0Uq1Ld","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 and related location data, billed per-call via x402/USDC micropayments.","exampleAgentPrompt":"What are the geographic coordinates for Lisbon, Portugal? I need the latitude and longitude — return up to 3 results.","exampleUseCases":null,"resultDescription":"Returns one or more candidate locations matching the query, each with latitude, longitude, and associated geographic metadata such as display name and bounding box.","failureModes":["Missing required parameter 'q' returns 400 Bad Request","Unknown or misspelled place name returns empty results array","Payment not included or insufficient results in 402 Payment Required with x402 challenge","Rate limiting or server unavailability returns 5xx error","Ambiguous place name may return unexpected top result without sufficient limit parameter"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to resolve a human-readable place name into geographic coordinates in a pay-as-you-go fashion with no API key or subscription required. Ideal for agents that need occasional geocoding without upfront commitment, especially in x402-enabled micropayment pipelines on Base/USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T19:27:34.428Z","isFirstParty":false}