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

Эндпоинт GET /v2/{sportSlug}/search ищет по трём типам сущностей одновременно:

• player (игроки)
• team (команды)
• tournament (турниры)

Поиск работает по русским и английским названиям.

Пример

curl -H "Authorization: YOUR_KEY" \
  "https://api.api-sport.ru/v2/football/search?q=Манчестер&limit=10"

{
  "query": "Манчестер",
  "results": {
    "players": { "total": 0, "items": [] },
    "teams": {
      "total": 2,
      "items": [
        { "id": 100, "name": "Manchester City",   "translation": { "ru": "Манчестер Сити" } },
        { "id": 101, "name": "Manchester United", "translation": { "ru": "Манчестер Юнайтед" } }
      ]
    },
    "tournaments": {
      "total": 1,
      "items": [
        { "id": 50, "name": "Manchester Derby Cup" }
      ]
    }
  }
}

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

Query-параметры

Параметр	Тип	Значение
q	string	Обязательно. Поисковая строка. Если пустая — 400 Missing required parameter "q".
type	string	CSV из player, team, tournament. Singular, не plural. По умолчанию все три.
limit	int	1–50, default 20. Лимит элементов на каждый тип.
offset	int	0–500, default 0.
country	string	ISO-2 (RU, ES, GB). Фильтр по принадлежности игрока/клуба/турнира.

Многоязычный поиск

Запрос q=Cherchesov найдёт Stas Cherchesov и одновременно Стас Черчесов. Не нужно дублировать запрос на двух языках.

Ошибки

• 400 Missing required parameter "q" — пустой / отсутствующий q.
• 400 Invalid type. Allowed values: player, team, tournament — некорректный type.
• 400 Invalid sport — спорт не найден (необычно — обычно ловится middleware'ом раньше).

Cross-sport поиск

Эндпоинт scoped к одному sportSlug. Для поиска по нескольким спортам — параллельные запросы (см. Recipe → search-multilingual).