{"uid":"cap_U3bkcQArhHHgZxEdnY1j8","slug":"x402-zoo-random-city-lookup-cb50de4c","name":"x402-zoo Random City Lookup","description":"Return a real city from a curated worldwide city sample with country and coordinates.","url":"https://x402-zoo.lolagent.workers.dev/api/random-city","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"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"seed":{"type":"string"},"country":{"type":"string"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aQyUvmAEtF9MudSs7GaXl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a real city from a curated worldwide sample, including country and geographic coordinates.","exampleAgentPrompt":"Give me a random real city from anywhere in the world — I need its name, country, and coordinates.","exampleUseCases":[{"title":"Random geography quiz question","prompt":"Pick a random city from anywhere in the world and give me its name and country so I can use it as a geography quiz question."},{"title":"Seeded city for reproducible test data","prompt":"I need a random city with coordinates for my test suite — can you get one using the seed 'testcase42' so I always get the same result?"},{"title":"Random city filtered by country","prompt":"Give me a random real city from Japan with its latitude and longitude — I'm populating a map demo."}],"resultDescription":"Returns a JSON object containing a real city name, its country, and geographic coordinates (latitude and longitude) drawn from a curated worldwide sample. Optionally reproducible via a seed parameter or filterable by country.","failureModes":["Invalid or unrecognized country code returns no results or an error","Network timeout from the Cloudflare Worker","Payment failure via x402 protocol prevents access","Seed parameter producing no matching city for the given country filter"],"whenToPreferThis":"Choose this endpoint when you need a quick, real-world city name with coordinates from a global sample — ideal for seeding test data, geography quizzes, map demos, or any scenario requiring a plausible random location. Prefer it over geocoding APIs when you don't have a specific city in mind and just need a valid real-world city. The optional seed parameter makes it suitable for reproducible randomness.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:59:49.024Z","isFirstParty":false}