{"uid":"cap_57d8su7CeadPuZNB6aGin","slug":"meterly-ai-wft-geodb-geographic-database-lookup-90f21c1f","name":"Meterly.Ai WFT GeoDB — Geographic Database Lookup","description":"Pay-per-call API infrastructure for AI agents, bots, and developers. Access 95+ premium APIs with USDC payments on Base Mainnet via x402 protocol.","url":"https://meterly-ai.vercel.app/api/v1/wft-geo-db","method":"POST","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","required":["query"],"properties":{"url":{"type":"string","description":"URL to process"},"limit":{"type":"number","description":"Maximum results to return"},"query":{"type":"string","description":"Search query or input data"},"username":{"type":"string","description":"Username or profile identifier"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2wofwB7o09TvGQEDrGpX_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches a geographic database (GeoDB) to retrieve location, city, region, or population data based on a text query, proxied through Meterly.Ai's pay-per-call x402 infrastructure.","exampleAgentPrompt":"Search the geographic database for cities named 'Springfield' and return up to 10 results with their country, region, and population details.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing geographic database records matching the query — likely including city names, country codes, region/state information, population figures, and geographic coordinates, depending on the underlying GeoDB API response.","failureModes":["Empty or missing 'query' field returns a 400 validation error","Query matches no records — returns empty results array","GeoDB upstream service unavailable — 502 or 503 error","Payment failure via x402 protocol — 402 Payment Required if USDC balance is insufficient","Rate limiting or quota exceeded on the underlying GeoDB API","Invalid 'limit' value (e.g. negative integer) may cause unexpected behavior"],"whenToPreferThis":"Use this endpoint when you need to look up structured geographic data — cities, regions, populations, coordinates — by name or keyword, and you are operating in an x402/USDC payment environment. Prefer this over manual geocoding when you need rich city-level metadata rather than just lat/lng. Best for agents that already use Meterly.Ai's pay-per-call infrastructure and want a single unified billing surface for multiple APIs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:15.234Z","isFirstParty":false}