Dota Clips API

Get the top clips from any Dota game and embed them on your site. It's free and you don't need an API key.

Get a game's clips

GET https://dotaclips.com/api/games/MATCH_ID/clips

This returns every clip from the game, highest score first. You can call it straight from the browser.

{
  "clips": [
    {
      "id": "bslsMt7baK",
      "title": "Rampage",
      "player": "Jeff Pesos",
      "score": 14.2,
      "thumbnail": "https://media.dotaclips.com/clips/bslsMt7baK.jpg",
      "url": "https://dotaclips.com/c/bslsMt7baK",
      "embed": {
        "url": "https://dotaclips.com/embed/bslsMt7baK",
        "html": "<iframe src=\"https://dotaclips.com/embed/bslsMt7baK\" ...></iframe>"
      }
    }
  ]
}

Each clip comes with an embed. Paste its html into your page and the video shows up, the same way a YouTube embed works.

If the game has no clips, clips is an empty list. Results can be up to a minute old.

Scores

Scores work the same way in every game, so you can compare clips from different matches. For example, to get the best clips from a series, get the clips for each of its games, combine them, and sort by score.

A clip's score is the total of points for what happened in it: kills (multi-kills are worth more), assists, stuns and big spells that set up kills, saving or reviving teammates, how much of the team's damage the player dealt, and how much the fight raised the team's chance of winning, with extra when it turned the game around. Rare moments like Roshan steals, Rapier drops and ending kill streaks are worth extra too. Dying in the fight costs points, and fights in a game that was already decided count less. Clips that people like and share on Dota Clips get a small boost.

Every clip scores at least 3. A typical clip scores about 7, the top 10% score 14 or more, and the top 1% score 26 or more.

Which games have clips

We only clip games that include at least one player who uses Dota Clips. If nobody in a game does, it won't have any clips. Clips usually show up about ten minutes after a game ends.

Questions

Email jake@dotaclips.com.