{"uid":"cap_HaHls6kNDoCeMdYsC_oRf","slug":"astro-dutchdata-io-location-search-us-ny-2c7a210d","name":"astro.dutchdata.io Location Search (US/NY)","description":"Location data","url":"https://astro.dutchdata.io/api/locations/US/NY/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","properties":{"queryParams":{"type":"object","properties":{"limit":{"type":"string","description":"Maximum results (default 50)"},"query":{"type":"string","description":"City-name search text"},"region_code":{"in":"path","type":"string","description":"path parameter"},"country_code":{"in":"path","type":"string","description":"path parameter"}}}}},"output":{"type":"object","properties":{"example":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RichLocation"}},"example":[{"id":5128581,"lat":40.71427,"lon":-74.00597,"city":"New York","timezone":"America/New_York","population":8804190,"region_code":"NY","country_code":"US"}],"mimeType":"application/json"}}}},"description":"x402 Bazaar discovery metadata"},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q9aGdsYb-4CWAywpGwIxv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches for cities and locations within a US state (e.g. New York) by name query, returning rich location data including coordinates, timezone, and population","exampleAgentPrompt":"Can you search for cities named 'Rochester' in New York state (US/NY) and give me back their coordinates, timezone, and population?","exampleUseCases":null,"resultDescription":"A JSON array of location objects, each containing: numeric location ID, latitude, longitude, city name, IANA timezone string, population count, region_code (e.g. 'NY'), and country_code (e.g. 'US'). Default limit is 50 results.","failureModes":["No matching cities found for the query string — returns empty array","Invalid region_code or country_code path parameter — may return 404 or empty result","Missing query parameter — may return all locations up to the limit or an error","Payment not processed (x402) — returns 402 Payment Required before data is delivered","Rate limiting or service unavailability — returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need to search for cities or locations within a specific US state by partial or full name, and want rich location metadata (coordinates, timezone, population) in return. Prefer this over generic geocoding APIs when you specifically need to filter by US state/region and want structured city-level data with population included.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:32:16.192Z","isFirstParty":false}