{
  "name": "Back of the Box",
  "summary": "Guess the film from a spoiler-free plot summary written in the style of a rental case. Two calls: deal a game, then submit your answers.",
  "documentation": "https://playbackofthebox.com/llms.txt",
  "catalogue": {
    "films": 1008,
    "from": 1940,
    "to": 2025,
    "language": "en"
  },
  "formats": [
    {
      "format": "ten",
      "description": "Exactly 10 rounds, all scored."
    },
    {
      "format": "survival",
      "description": "Rounds are dealt in one batch; scoring stops at your first wrong answer."
    }
  ],
  "difficulties": [
    {
      "difficulty": "casual",
      "tiers": [
        1
      ],
      "secondsPerRound": 25,
      "decoys": "loose"
    },
    {
      "difficulty": "classic",
      "tiers": [
        1,
        2
      ],
      "secondsPerRound": 20,
      "decoys": "medium"
    },
    {
      "difficulty": "cinephile",
      "tiers": [
        1,
        2,
        3
      ],
      "secondsPerRound": 20,
      "decoys": "tight"
    }
  ],
  "scoring": {
    "base": 100,
    "speedBonusMax": 100,
    "obscurityBonus": {
      "tier1": 0,
      "tier2": 25,
      "tier3": 50
    },
    "streakMultipliers": [
      {
        "fromStreak": 0,
        "multiplier": 1
      },
      {
        "fromStreak": 2,
        "multiplier": 1.25
      },
      {
        "fromStreak": 4,
        "multiplier": 1.5
      },
      {
        "fromStreak": 6,
        "multiplier": 2
      }
    ],
    "perfectGameBonus": 250,
    "note": "The speed bonus is only applied if you report per-round times and they sum to no more than the wall-clock time the game has been open."
  },
  "endpoints": [
    {
      "method": "POST",
      "url": "https://playbackofthebox.com/api/game",
      "body": {
        "difficulty": "optional, one of casual | classic | cinephile (default classic)",
        "format": "optional, one of ten | survival (default ten)",
        "rounds": "optional, survival only, 1-100 (default 40)"
      },
      "returns": "A token plus the rounds, each with a blurb and four options. Answers are withheld."
    },
    {
      "method": "POST",
      "url": "https://playbackofthebox.com/api/game/score",
      "body": {
        "token": "the token from POST /api/game",
        "answers": "array of option ids in round order; null or omitted counts as wrong",
        "times": "optional array of milliseconds spent per round"
      },
      "returns": "Per-round correctness with the right answer revealed, plus the total score."
    }
  ],
  "example": {
    "deal": "curl -sX POST https://playbackofthebox.com/api/game -H 'content-type: application/json' -d '{\"format\":\"survival\",\"difficulty\":\"classic\"}'",
    "submit": "curl -sX POST https://playbackofthebox.com/api/game/score -H 'content-type: application/json' -d '{\"token\":\"...\",\"answers\":[\"casablanca-1942\"]}'"
  }
}