Core Concepts

Getting Started

A high-level walkthrough of The Entertainment Graph®.

Welcome to The Entertainment Graph, built by MediaHound.

We bring together all movies and television as well as the people and concepts that connect that content. The result is an incredibly meaningful web of context and discovery that can power a great variety of products and experiences.

You will find a high-level diagram of some of the relationships and objects in The Entertainment Graph below. For more details on the company behind The Entertainment Graph, visit MediaHound.com.

Movie Relationships

Try MediaHound

Check out try.mediahound.com if you'd like to explore what our API can do in an intuitive playground before you start building an app.

Search for a Movie

Let's take a look at using the REST API to access The Entertainment Graph.

The Entertainment Graph is filled with content of all different types: movies, TV shows, directors, etc. We provide Universal Search across all of this content. To keep our results simple for this example, let's use the MediaHound API to search for one movie:

Request

curl \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{ "returnType": "Movie", "searchTerm": "Gladiator"}' \
  --user API_USER:API_PASSWORD \
  https://api.mediahound.net/graph/search

Note: You will need an API_USER and API_PASSWORD to authenticate and access the MediaHound API.

Discover what else you can do with Search.

Response

We searched for the string, "Gladiator," and filtered the results to movies. Gladiator (2000) is returned as we would expect:

{
  "content": [
    {
      "object": {
        "mhid": "mhmovPeR81SeVnIPqEFsr36NYUqfqHuXzO9lDuQkq72G",
        "name": "Gladiator",
        "altId": "mhmov-gladiator",
        "releaseDate": 946684800,
        "description": "A disgraced Roman general, played by Russell Crowe, is forced to fight in the iconic Coliseum as a gladiator for the entertainment of the people, and the man responsible for his downfall.",
        "primaryImage": {
          "object": {
            "mhid": "mhimgGttJE3CaxHXF7rD5aiCOj5hXrHgNMLcutexcBpU",
            "name": "Gladiator 2000",
            "isDefault": false,
            "original": {
              "url": "https://images.mediahound.com/media/mhimgGttJE3CaxHXF7rD5aiCOj5hXrHgNMLcutexcBpU.jpg",
              "height": 1500,
              "width": 1000
            },
            "thumbnail": {
              "url": "https://images.mediahound.com/media/mhimgWZoLyvf3bv432dhEM4oE4OgcE2u0Yxc4Ow0nB2b.jpg",
              "height": 135,
              "width": 90
            },
            "small": {
              "url": "https://images.mediahound.com/media/mhimg0cqGrgTH3ocaK82fK9Sdnj5UEo2UJ537sXy7RUf.jpg",
              "height": 270,
              "width": 180
            },
            "medium": {
              "url": "https://images.mediahound.com/media/mhimgMQ5RVnfPadqmojTjpHgROSPq1xtsVcV6iCVzSpJ.jpg",
              "height": 540,
              "width": 360
            },
            "large": {
              "url": "https://images.mediahound.com/media/mhimgPsgfqjlk5WGNTMPVyFj90DHtbWiqDAyqHzjAv6R.jpg",
              "height": 1080,
              "width": 720
            }
          },
          "context": {}
        },
        "primaryName": {
          "object": {
            "name": "Gladiator"
          },
          "context": null
        },
        "keyContributors": {
          "content": [
            {
              "object": {
                "mhid": "mhricdHv2eCnYem0LZ5rNMCgBOesPtPAxPbwhNd9Pvub",
                "name": "Ridley Scott",
                "altId": "mhric-ridley-scott"
              },
              "context": {
                "sorting": {
                  "importance": 1
                },
                "relationships": [
                  {
                    "contribution": "Director"
                  },
                  {
                    "contribution": "Producer"
                  }
                ]
              }
            },
            {
              "object": {
                "mhid": "mhricPM4FE1LAJ4HoahHtcEXfXISghonBm1xqdwbQfyJ",
                "name": "Russell Crowe",
                "altId": "mhric-russell-crowe"
              },
              "context": {
                "sorting": {
                  "importance": 2
                },
                "relationships": [
                  {
                    "contribution": "Cast",
                    "role": "Maximus"
                  }
                ]
              }
            },
            {
              "object": {
                "mhid": "mhricy1v4gGapcEcyCd1YWfMQea7VhdQFj0KHrnlEV6N",
                "name": "Joaquin Phoenix",
                "altId": "mhric-joaquin-phoenix"
              },
              "context": {
                "sorting": {
                  "importance": 3
                },
                "relationships": [
                  {
                    "contribution": "Cast",
                    "role": "Commodus"
                  }
                ]
              }
            },
            {
              "object": {
                "mhid": "mhric0ehJSnDfAkPbUiIbdL9eR6YwKFlvuaoUDtS7qo8",
                "name": "Connie Nielsen",
                "altId": "mhric-connie-nielsen"
              },
              "context": {
                "sorting": {
                  "importance": 4
                },
                "relationships": [
                  {
                    "contribution": "Cast",
                    "role": "Lucilla"
                  }
                ]
              }
            },
            {
              "object": {
                "mhid": "mhricx7OJojMdAP5Shne5Hbu57bweBIlcPq26FvVYUQC",
                "name": "Oliver Reed",
                "altId": "mhric-oliver-reed"
              },
              "context": {
                "sorting": {
                  "importance": 5
                },
                "relationships": [
                  {
                    "contribution": "Cast",
                    "role": "Proximo"
                  }
                ]
              }
            }
          ]
        }
      },
      "context": {}
    }
  ]
}

You'll notice that this API request returned a paged response. This is true of most of the MediaHound API. Because of the size of The Entertainment Graph, we can't return everything to you at once. Instead, we chunk it up into pages and let you request more data one page at a time.

For more on the response structure, see API Objects.

All That Data

Looking at the above Search response example, you'll notice just how much data we have to offer. All Media has metadata — details like name, release date, etc.

Media, importantly, has connections to other objects in The Entertainment Graph. Movies have a list of people who helped create the movie. We call these people Contributors. Contributors can cross different Content types.

Explore Away!

We just explored the basics of The Entertainment Graph. This developer portal contains documentation about everything we have to offer.