{"uid":"cap_qV-EF8ydLmYw2LcsIrn-x","slug":"agents-openwebninja-com-local-business-data-autocomplete-9f9060b5","name":"Local Business Data Autocomplete","description":"Returns place/address, business and query predictions for text-based geographic queries.","url":"https://agents.openwebninja.com/local-business-data/autocomplete?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","example":"new y","description":"Search query"},"region":{"type":"string","default":"us","description":"Return results based to a particular region.  \n  For a list of supported region/country codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes (Alpha-2 code)*."},"language":{"type":"string","default":"en","description":"Set the language of the results.  \n  For a list of supported language codes see *https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2*."},"coordinates":{"type":"string","description":"Geographic coordinates of the location from which the query is applied - recommended to use so that results are biased towards this location.  \n  Defaults to some central location in the region (see the region parameter)."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["type","description","main_text"],"properties":{"type":{"type":"string","description":"Type of prediction. Values: place, query."},"country":{"type":"string","nullable":true,"description":"ISO 3166-1 alpha-2 country code of the predicted place; null for query predictions."},"latitude":{"type":"number","nullable":true,"description":"Latitude of the predicted place; null for query predictions."},"place_id":{"type":"string","nullable":true,"description":"Google Maps Place ID when the prediction is a place; null for query predictions."},"google_id":{"type":"string","nullable":true,"description":"Google identifier when the prediction is a place; null for query predictions."},"longitude":{"type":"number","nullable":true,"description":"Longitude of the predicted place; null for query predictions."},"main_text":{"type":"string","description":"Primary (left-hand) portion of the prediction text."},"description":{"type":"string","description":"Full prediction text suitable for display in the suggestion list."},"secondary_text":{"type":"string","nullable":true,"description":"Secondary (right-hand) portion of the prediction text (e.g. city / region)."},"main_text_highlights":{"type":"array","items":{"type":"object","properties":{"length":{"type":"integer","description":"Length of the highlighted span in characters."},"offset":{"type":"integer","description":"0-based character offset of the highlighted span."}}},"nullable":true,"description":"Substring highlights inside main_text (each {offset, length})."},"secondary_text_highlights":{"type":"array","items":{"type":"object","properties":{"length":{"type":"integer","description":"Length of the highlighted span in characters."},"offset":{"type":"integer","description":"0-based character offset of the highlighted span."}}},"nullable":true,"description":"Substring highlights inside secondary_text."}}},"description":"List of prediction objects."},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"The query as received."},"region":{"type":"string","description":"Region code used for the response."},"language":{"type":"string","description":"Language code used for the response."},"coordinates":{"type":"string","nullable":true,"description":"Geographic bias coordinates used (lat,lng)."}},"description":"The parameters the API received and used for this request, echoed back."},"request_id":{"type":"string","description":"A unique ID to trace the API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_hA8gWe78fDiNwDNIf6RyF","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns place, address, business, and query predictions for partial text-based geographic search queries, biased by region and coordinates.","exampleAgentPrompt":"Can you suggest autocomplete predictions for the partial query 'new y' biased toward the US region with coordinates 40.7128,-74.0060, so I can show place and business suggestions as the user types?","exampleUseCases":[{"title":"Location search box suggestions","prompt":"As the user types 'Starbucks San Fr' into our store locator, can you fetch place and business predictions for that partial text biased toward the US region so I can show a live dropdown of suggestions?"},{"title":"Address autocomplete for checkout form","prompt":"The customer has typed '123 Main' into the shipping address field — can you get address and place predictions for that partial input in the US so I can show them matching addresses to pick from?"},{"title":"Travel destination picker","prompt":"My user started typing 'eiffel' in the destination search bar — can you pull place predictions for that query in the France region (fr) in French so I can show them a list of matching landmarks to choose from?"}],"resultDescription":"Returns an array of prediction objects, each with a type ('place' or 'query'), a full description string, main_text and secondary_text for display, optional latitude/longitude, country code, Google Maps place_id and google_id, and highlight offset/length spans for both main and secondary text to render user-typed characters as bold. Also includes status, request_id, and echoed parameters.","failureModes":["Missing required 'query' parameter returns a validation error","Empty or very short query may return zero predictions","Invalid region or language code may fall back to defaults or return an error","Coordinates in wrong format (not 'lat,lng') may cause a parsing error or be ignored","Service unavailability or upstream Google Maps API issues return a non-200 status"],"whenToPreferThis":"Choose this endpoint when you need real-time place, address, or business autocomplete suggestions as a user types — especially when you want Google Maps-quality predictions with place IDs and coordinates, and you need results biased to a specific region or geographic coordinate. Prefer over generic geocoders when you need incremental suggestions with highlight metadata for UI rendering, or when you want both place predictions and open-ended query suggestions in the same response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:13.852Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-local-business-data-autocomplete-9f9060b5"}