Поиск игр

API предоставляет два endpoint'а для поиска: полный поиск и быстрые подсказки.

GET /catalog/search

Полнотекстовый поиск игр по PSN и Battle.net с фильтрацией и пагинацией.

Один endpoint выдаёт унифицированные результаты по обеим платформам с ценами, регионами и ссылками.

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

Параметр	Тип	Обязательный	Описание
`q`	string	Да	Поисковый запрос (минимум 2 символа)
`platform`	string	Нет	Фильтр по платформе: `all`, `psn`, `battlenet` (по умолчанию `all`)
`limit`	number	Нет	Количество результатов (1-100, по умолчанию 10)
`offset`	number	Нет	Смещение для пагинации (по умолчанию 0)
`includeRelated`	boolean	Нет	Включить связанные товары (DLC, editions)
`includeMembers`	boolean	Нет	Включить членов коллекций

Пример запроса (cURL)

curl -H "Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/catalog/search?q=god+of+war&platform=psn&limit=5&includeRelated=1"

Пример запроса (JavaScript)

const response = await fetch(
  'https://gapi.qb2.ru/api/v1/catalog/search?' + new URLSearchParams({
    q: 'god of war',
    platform: 'psn',
    limit: '5',
    includeRelated: '1'
  }),
  {
    headers: {
      'Authorization': 'Bearer gapi_xxxxxxxxxxxxxxxxxxxxx'
    }
  }
);

const data = await response.json();

Пример запроса (Python)

import requests

response = requests.get(
    'https://gapi.qb2.ru/api/v1/catalog/search',
    params={
        'q': 'god of war',
        'platform': 'psn',
        'limit': 5,
        'includeRelated': 1
    },
    headers={'Authorization': 'Bearer gapi_xxxxxxxxxxxxxxxxxxxxx'}
)

data = response.json()

Пример ответа

{
  "ok": true,
  "data": {
    "results": [
      {
        "id": "6754AQWE",
        "platform": "psn",
        "title": "God of War Ragnarök",
        "type": "game",
        "thumbnail": "https://...",
        "price": {
          "value": 4999,
          "currency": "RUB",
          "formatted": "4 999 ₽"
        },
        "regions": ["ru", "us", "eu"],
        "storeUrl": "https://store.playstation.com/..."
      }
    ],
    "total": 42,
    "limit": 5,
    "offset": 0
  },
  "meta": {
    "timestamp": "2026-05-05T13:45:00.000Z",
    "rateLimit": {
      "limit": 30,
      "remaining": 27,
      "resetAt": "2026-05-05T14:00:00.000Z"
    }
  }
}

GET /catalog/suggest

Быстрые подсказки для автодополнения (меньше данных, быстрее отвечает).

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

Параметр	Тип	Обязательный	Описание
`q`	string	Да	Поисковый запрос (минимум 2 символа)
`platform`	string	Нет	Фильтр по платформе: `all`, `psn`, `battlenet`
`limit`	number	Нет	Количество результатов (1-20, по умолчанию 8)

Пример запроса

curl -H "Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/catalog/suggest?q=witcher&limit=8"

Пример ответа

{
  "ok": true,
  "data": {
    "suggestions": [
      {
        "id": "CUSA05571",
        "platform": "psn",
        "title": "The Witcher 3: Wild Hunt",
        "thumbnail": "https://..."
      },
      {
        "id": "the-witcher-3-wild-hunt",
        "platform": "battlenet",
        "title": "The Witcher 3: Wild Hunt",
        "thumbnail": "https://..."
      }
    ]
  }
}

Особенности поиска

Поиск чувствителен к языку: для русских игр используйте русские названия, для английских — английские.

Советы по использованию

Минимальная длина запроса — 2 символа
Пагинация — Используйте offset и limit для больших результатов
Фильтрация — Указывайте platform для ускорения поиска
Связанные товары — includeRelated=1 добавляет DLC и editions
Автодополнение — Используйте /suggest для быстрых подсказок

Типы результатов

game — Основная игра
dlc — Дополнительный контент
edition — Специальное издание
bundle — Набор игр
subscription — Подписка

Rate Limiting

Оба endpoint'а учитываются в общем лимите:

30 запросов в минуту
43200 запросов в сутки

Проверяйте заголовки X-RateLimit-* в ответе для отслеживания лимитов.

Поиск игр

On this page