# AliExpress Autocomplete API Documentation

<p><strong>AliExpress Autocomplete API Documentation</strong> Get the search suggestions AliExpress shows while a shopper types. Pass the first letters of a keyword and read the suggestions list. Use the suggestions as query values for the search endpoint. Currency and language follow the market of the request, so they can differ between calls. Failed requests are never charged.</p>

- **Documentation:** [https://scrappa.co/docs/aliexpress-api/aliexpress_autocomplete](https://scrappa.co/docs/aliexpress-api/aliexpress_autocomplete)
- **API group:** AliExpress API
- **Endpoint:** `GET https://scrappa.co/api/aliexpress/autocomplete`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Keyword prefix, e.g. phone. |

## Example response

```json
{
    "data": {
        "query": "phone",
        "suggestions": [
            "phone case",
            "phones mobile"
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "autocomplete"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | AliExpress could not be reached. Retry after a short pause. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)