Getting Started

All API requests require two HTTP headers:

Search

Example:

curl -H 'Accept: application/json' -H 'X-API-KEY: YOUR_API_KEY_HERE' -v -i 'https://www.doesthedogdie.com/dddsearch?q=old%20yeller'

{
  "items": [{
    "id": 10752,
    "name": "Old Yeller",
    "cleanName": "oldyeller",
    "genre": "adventure",
    "releaseYear": "1957",
    "legacyId": 2326,
    "legacyUserId": 28,
    "umId": null,
    "legacyItemType": "movie",
    "newsletterDate": null,
    "createdAt": "2017-06-22T18:20:34.000Z",
    "updatedAt": "2020-03-14T17:31:39.000Z",
    "UserId": 12972,
    "ItemTypeId": 15,
    "tmdbId": 22660,
    "imdbId": null,
    "backgroundImage": "dYxm1GXu9AJtTzZvVm871nsWQjr.jpg",
    "posterImage": "cpmJyQpmg6fF8VkBUAAFIs8tLKh.jpg",
    "tmdbResult": null,
    "overview": "Young Travis Coates is left to take care of the family ranch with his mother and younger brother while his father goes off on a cattle drive in the 1860s. When a yellow mongrel comes for an uninvited stay with the family, Travis reluctantly adopts the dog.",
    "itemType": {
      "id": 15,
      "name": "Movie"
    },
    "itemTypeId": 15
  }, {
    "id": 8893,
    "name": "Best Doggone Dog In the West: the Making of Walt Disneys Old Yeller",
    "cleanName": "bestdoggonedoginwestthemakingofwaltdisneysoldyeller",
    "genre": null,
    "releaseYear": "Unknown",
    "art": null,
    "legacyId": 463,
    "legacyUserId": 28,
    "umId": null,
    "legacyItemType": "movie",
    "newsletterDate": null,
    "createdAt": "2017-06-22T18:20:34.000Z",
    "updatedAt": "2019-11-18T21:23:16.000Z",
    "UserId": 12972,
    "ItemTypeId": 15,
    "tmdbId": null,
    "imdbId": null,
    "backgroundImage": null,
    "posterImage": null,
    "tmdbResult": "\"no match\"",
    "overview": null,
    "itemType": {
      "id": 15,
      "name": "Movie"
    },
    "itemTypeId": 15
  },
  ...
}

Media

Example:

curl -H 'Accept: application/json' -H 'X-API-KEY: YOUR_API_KEY_HERE' 'https://www.doesthedogdie.com/media/10752'

{
  "item": {
    "id": 10752,
    "name": "Old Yeller",
    "cleanName": "oldyeller",
    "genre": "adventure",
    "releaseYear": "1957",
    "legacyId": 2326,
    "legacyUserId": 28,
    "legacyItemType": "movie",
    "art": "http://image.tmdb.org/t/p/original/cpmJyQpmg6fF8VkBUAAFIs8tLKh.jpg",
    "umId": null,
    "tmdbId": 22660,
    "tmdbResult": null,
    "backgroundImage": "dYxm1GXu9AJtTzZvVm871nsWQjr.jpg",
    "posterImage": "cpmJyQpmg6fF8VkBUAAFIs8tLKh.jpg",
    "overview": "Young Travis Coates is left to take care of the family ranch with his mother and younger brother while his father goes off on a cattle drive in the 1860s. When a yellow mongrel comes for an uninvited stay with the family, Travis reluctantly adopts the dog.",
    "createdAt": "2017-06-22T18:20:34.000Z",
    "updatedAt": "2020-03-14T17:31:39.000Z",
    "UserId": 12972,
    "ItemTypeId": 15,
    "itemType": {
      "id": 15,
      "name": "Movie",
      "picture": "clapperboard",
      "slug": "movies",
      "verb": "watch",
      "pastTenseVerb": "watched",
      "createdAt": "2019-02-19T13:02:35.000Z",
      "updatedAt": "2019-02-19T13:02:35.000Z"
    }
  },
  "topicItemStats": [{
    "topicItemId": 395866,
    "newsletterDate": null,
    "yesSum": 57,
    "noSum": 3,
    "numComments": 7,
    "TopicId": 153,
    "ItemId": 10752,
    "RatingId": 304065,
    "commentUserIds": "13297,14057,17582,27610,45484",
    "voteSum": 26,
    "comment": "Yes the dog dies. He's shot by his owner after contracting rabies.",
    "isAnonymous": 0,
    "username": "DoesTheDogDie",
    "UserId": 13297,
    "verified": 1,
    "itemName": "Old Yeller",
    "itemCleanName": "oldyeller",
    "releaseYear": "1957",
    "itemTypeName": "Movie",
    "itemTypeSlug": "movies",
    "itemTypeId": 15,
    "isYes": 1,
    "hasUserComment": false,
    "itemId": null,
    "comments": [{
      "id": 304065,
      "voteSum": 26,
      "comment": "Yes the dog dies. He's shot by his owner after contracting rabies.",
      "User": {
        "id": 13297,
        "displayName": "DoesTheDogDie"
      }
    }],
    "topic": {
      "id": 153,
      "name": "a dog dies",
      "notName": "no dogs die",
      "keywords": null,
      "description": null,
      "subtitle": null,
      "subtitleText": null,
      "subtitleUrl": null,
      "doesName": "Does the dog die",
      "listName": "where the dog dies",
      "image": "dog",
      "ordering": 100,
      "isSpoiler": false,
      "isVisible": true,
      "isSensitive": false,
      "smmwDescription": "dogs dying",
      "legacyId": 25,
      "createdAt": "2017-06-22T18:20:34.000Z",
      "updatedAt": "2017-06-22T18:20:34.000Z"
    }
  },
  ...