{"uid":"cap_lkVdVhfVttfk6W5MFqF-g","slug":"geocode-place-name-to-coordinates-country-timezone-and-population-09e53d80","name":"Geocode Place Name to Coordinates, Country, Timezone, and Population","description":"Geocode a place name to coordinates, country, timezone, population — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/geo/geocode?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"q":{"type":"string","description":"required: place name"},"limit":{"type":"integer","maximum":10,"minimum":1,"description":"optional: max rows (default 3, max 10)"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"geocode","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.001,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"name":"<source>"}],"limitations":"<text>","generated_at":"<iso time>","evidence_hash":"sha256:<64hex>"}},"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_cA2bfBeG0t44EeWFHV3_3","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":"Converts a place name (city, region, or landmark) into geographic coordinates, country, timezone, and population data","exampleAgentPrompt":"Look up the coordinates, country, timezone, and population for Nairobi and return up to 5 results.","exampleUseCases":[{"title":"Timezone lookup for meeting scheduler","prompt":"What timezone is São Paulo in? Give me its coordinates and country too so I can set up a meeting invite correctly."},{"title":"Population data for market research","prompt":"I need geographic details for Lagos including its coordinates, country, timezone, and population — can you look that up for me?"},{"title":"Disambiguate city name for travel planning","prompt":"I'm planning a trip to Springfield — can you geocode that place name and return up to 10 results so I can see which Springfield is the most populated one?"}],"resultDescription":"Returns one or more matching places (up to the requested limit, default 3, max 10), each with geographic coordinates (latitude/longitude), country, timezone identifier, and population figure.","failureModes":["Place name not found or too ambiguous — returns empty results array","Limit parameter out of range (below 1 or above 10) — may return error or be clamped","Misspelled or non-existent place name — returns no results","Payment not completed via x402 protocol — request rejected before processing","Rate limiting or network timeout on the upstream geocoding provider"],"whenToPreferThis":"Choose this endpoint when you need structured geographic metadata (coordinates, timezone, country, population) from a human-readable place name, especially within a pay-per-call micropayment context using x402. Prefer it over raw geocoding APIs when you also need timezone and population in a single call, or when you are operating in an agentic pipeline that already handles x402 payments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T02:40:20.137Z","isFirstParty":false,"canonicalSlug":"geocode-place-name-to-coordinates-country-timezone-and-population-09e53d80"}