Return up to 20 search suggestions for a text, for example a make, a model, a colour or a body type. Each suggestion carries ready-made filter strings in the same grammar as the search endpoint, a score and the page URL.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
Search text, at least 2 characters, for example swift.
coffee shops
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 422
A parameter is invalid. This response is not billable.
HTTP 503
The upstream refused the request, is unavailable, changed its answer shape or did not honour a filter, the sort or the cursor (error.code PARSER_DRIFT, UPSTREAM_FILTER_MISMATCH, UPSTREAM_BLOCKED or UPSTREAM_UNAVAILABLE). No data is returned. This response is not billable.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.