Overview

This node performs an autocomplete operation specifically for locations using the Ocean.io API. It takes a partial location query (such as a city, region, or metro area) and returns up to 15 matching location suggestions. This is useful for refining city-level filters in workflows, especially when the broader country-level filters are insufficient. For example, it can help users quickly find and select the correct city or region name before proceeding with more detailed searches or enrichments.

Use Case Examples

1. A marketing team wants to filter leads by specific metro areas rather than entire countries. They input partial city names to get accurate location suggestions.
2. A CRM system uses this node to help users select the correct city name from a list of autocomplete suggestions, improving data quality before further processing.

Properties

Output

JSON

• locations - An array of up to 15 location strings matching the query, such as city names, regions, or metro areas.

Dependencies

• Requires an API key credential for Ocean.io to authenticate requests.

Troubleshooting

• Ensure the 'query' parameter is not empty; the node throws an error if the query is missing.
• If the API returns a 402 error, it indicates insufficient credit balance in the Ocean.io account.
• Check that the resource is set to 'autocomplete' and the operation to 'locations' to avoid unknown operation errors.

Links

• Ocean.io Autocomplete API Documentation - Official documentation for the autocomplete endpoints, including locations.