# Yandex Suggest API Documentation

Return up to 10 Yandex search suggestions for the beginning of a query, in English, Russian or Turkish. Use them for autocomplete or keyword research. Each successful request costs 1 credit.

- **Documentation:** [https://scrappa.co/docs/yandex-api/yandex_suggest](https://scrappa.co/docs/yandex-api/yandex_suggest)
- **API group:** Yandex API
- **Endpoint:** `GET https://scrappa.co/api/yandex/suggest`

## 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 |
| --- | --- | --- | --- |
| `text` | string | Yes | Text start. Alias: q. |
| `lang` | string | No | Suggestion language: en (default), ru or tr. |

## Example response

```json
{
    "meta": {
        "billable": true,
        "duration_ms": 2400,
        "upstream_calls": 2
    },
    "success": true,
    "suggestions": [
        {
            "value": "tiger broker",
            "position": 1
        },
        {
            "value": "tiger trade",
            "position": 2
        }
    ],
    "search_information": {
        "lang": "en",
        "query": "tiger"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | Returned when a required parameter is missing, a value is out of range or a parameter is not supported. No credits are charged. |
| 503 | Service Unavailable | Returned when Yandex could not be read after several attempts. Failed requests are not charged. Try again. |
| 502 | Unexpected Response | Returned when Yandex answers with a page this API cannot read, or an image cannot be read. Failed requests are not charged. |

## 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)