API для разработчиков

Получайте лучшие обложки, логотипы, иконки и фоны для настольных игр одним запросом. По внутреннему ID или ID BoardGameGeek и Tesera.

Получить ключДокументация (OpenAPI)

Как начать

  1. Зарегистрируйтесь и создайте ключ в настройках.
  2. Передавайте ключ в заголовке Authorization: Bearer КЛЮЧ.
  3. Вызывайте /api/v1/games/best — и получайте URL картинок.

Примеры

Лучшие ассеты по BGG ID
curl -H "Authorization: Bearer bgd_…" \
  "https://bggriddb.ru/api/v1/games/best?platform=bgg&ids=174430,167791&types=cover,logo,icon&aspect=1:1&lang=ru"
{
  "success": true,
  "data": [
    { "id": "174430", "gameId": 12, "status": 200,
      "assets": {
        "cover": { "id": 345, "url": "https://…/o/cover/ab/….jpg", "variants": { "1024x1024": "https://…webp" }, "thumb": "https://…_300.webp", … },
        "logo":  { … }, "icon": { …, "ico": "https://…/i/….ico" }
      } }
  ]
}
Все обложки игры
GET https://bggriddb.ru/api/v1/covers/game/12?aspects=1:1,2:3&styles=official&sort=score&limit=25
GET https://bggriddb.ru/api/v1/covers/by/bgg/174430?language=ru,none
Связи игр: дополнения, переиздания, серии

Семейство отдаётся целиком от базовой игры, даже если запросить дополнение. Дерево собирается по parentId, вид записи — в kind: base, expansion, pack, standalone, collection, edition, promo, fan, accessory. Серии объединяют самостоятельные игры одной линейки.

GET https://bggriddb.ru/api/v1/games/by/bgg/237182/family
GET https://bggriddb.ru/api/v1/series?q=unmatched
GET https://bggriddb.ru/api/v1/series/{id}
{
  "success": true,
  "data": {
    "rootId": 3,
    "root": { "id": 3, "kind": "base", "name": "Root", "seriesId": null, … },
    "nodes": [
      { "id": 26015, "kind": "expansion", "parentId": 3, "name": "Root: The Riverfolk Expansion", … },
      { "id": 29092, "kind": "pack", "parentId": 3, … }
    ],
    "series": null
  }
}
Загрузка логотипа
curl -H "Authorization: Bearer bgd_…" -F game_id=12 -F style=white -F language=ru \
  -F file=@logo.png "https://bggriddb.ru/api/v1/logos"

Лимиты

По умолчанию 120 запросов в минуту и 5000 в сутки на ключ. Для интеграций с большим объёмом напишите нам — есть партнёрский тариф.

Типы ассетов

Размеры, группы пропорций и стили доступны программно: GET /api/v1/meta/asset-types.

Лицензия контента

Контент загружен пользователями и предоставляется «как есть» для некоммерческого использования. Указывайте автора (username) и ссылку на ассет, где это возможно.