{"uid":"cap_r8VZ8u5Z2rvr_a-bhrgjV","slug":"aviato-geocoder-search-d6746787","name":"Aviato Geocoder Search","description":"Search for a location and get geocoded matches. Use the geocoded ID with person/company search locationIDList filter.","url":"https://x402.orthogonal.com/aviato/geocoder/search","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","properties":{"text":{"type":"string","description":"Location search query"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0KMPck6BK9qWzWC8cREAC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for a location by text and return geocoded matches with IDs usable in person/company search filters","exampleAgentPrompt":"Search for 'Austin, Texas' using the Aviato geocoder and give me the location ID so I can use it to filter a people search.","exampleUseCases":[{"title":"Geocode city for talent search","prompt":"I want to search for software engineers in Seattle — can you look up the geocoded ID for Seattle so I can plug it into the people search filter?"},{"title":"Resolve location before company lookup","prompt":"I need to find companies headquartered in Boston. Can you geocode 'Boston, MA' and get me the location ID to use in the company search?"},{"title":"Disambiguate city name for search filter","prompt":"I'm building a filter for a professional search and need the exact location ID for 'San Francisco, CA' — can you run it through the geocoder and return the best match?"}],"resultDescription":"Returns a list of geocoded location matches for the query text, including location IDs and names. The location ID from the results can then be passed to Aviato person or company search endpoints as a locationIDList filter parameter.","failureModes":["Empty or ambiguous query text returns no matches or ambiguous results","Misspelled or unrecognized location names may return zero results","Rate limiting or payment failure returns an HTTP 402 or 429 error","Very broad queries like 'United States' may return many low-utility results"],"whenToPreferThis":"Use this endpoint when you need to translate a human-readable location name (city, region, metro area) into a structured geocoded ID for use with Aviato's person or company search endpoints. It is the required prerequisite step before filtering professional searches by geography on the Aviato platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:00:44.196Z","isFirstParty":false}