Мультиязычный поиск

Эндпоинт /v2/{sportSlug}/search ищет в EN и RU индексах одновременно. Один запрос q=Cherchesov найдёт и Стас Черчесов, и наоборот — q=Месси найдёт Lionel Messi.

Базовый запрос

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.api-sport.ru/v2/football/search?q=Месси&limit=5"

Параметры запроса

Параметр	Тип	Значение
q	string	Обязательно. Поисковый запрос.
type	string	CSV-список из player, team, tournament. По умолчанию ищет во всех трёх.
limit	integer	1–50, default 20. Максимум элементов на каждый тип.
offset	integer	0–500, default 0.
country	string	ISO-2 код страны (например, RU, ES). Фильтр по принадлежности игрока/клуба/турнира.

Ответ

{
  "query": "Месси",
  "results": {
    "players": {
      "total": 1,
      "items": [
        {
          "id": 1234,
          "name": "Lionel Messi",
          "translations": { "ru": "Лионель Месси" }
        }
      ]
    },
    "teams": { "total": 0, "items": [] },
    "tournaments": { "total": 0, "items": [] }
  }
}

Ключи players / teams / tournaments в results появляются только для тех типов, что были запрошены через type= (или для всех трёх по умолчанию).

Поиск по выбранным типам

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.api-sport.ru/v2/football/search?q=Champions&type=tournament&limit=5"

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.api-sport.ru/v2/football/search?q=Реал&type=team,tournament"

Лучшие практики

• Передавайте непустую q — иначе вернётся 400 с error: 'Missing required parameter "q" (search query)'.
• Debounce на клиенте — 300 мс между нажатиями клавиш.
• Кэш повторяющихся запросов — поиск стабилен в рамках суток.
• Не показывайте «0 результатов» — лучше написать "ничего не найдено по запросу X" и предложить альтернативу.