API for developers

Fetch the best covers, logos, icons and backgrounds for board games in a single request. By internal ID, BoardGameGeek or Tesera ID.

Get a keyDocumentation (OpenAPI)

Getting started

  1. Sign up and create a key in settings.
  2. Send the key in the Authorization: Bearer KEY header.
  3. Call /api/v1/games/best and get image URLs.

Examples

Best assets by BGG ID
curl -H "Authorization: Bearer bgd_…" \
  "https://5e7889afa424.vps.myjino.ru/api/v1/games/best?platform=bgg&ids=174430,167791&types=cover,logo,icon&aspect=1:1&lang=en"
{
  "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" }
      } }
  ]
}
All covers of a game
GET https://5e7889afa424.vps.myjino.ru/api/v1/covers/game/12?aspects=1:1,2:3&styles=official&sort=score&limit=25
GET https://5e7889afa424.vps.myjino.ru/api/v1/covers/by/bgg/174430?language=ru,none
Upload a logo
curl -H "Authorization: Bearer bgd_…" -F game_id=12 -F style=white -F language=ru \
  -F file=@logo.png "https://5e7889afa424.vps.myjino.ru/api/v1/logos"

Limits

By default 120 requests per minute and 5000 per day per key. For high-volume integrations contact us — there is a partner tier.

Asset types

Sizes, aspect groups and styles are available programmatically: GET /api/v1/meta/asset-types.

Content license

Content is uploaded by users and provided as is for non-commercial use. Credit the author (username) and link to the asset where possible.