Getting Access to the API

Prerequisites

To access the IMDb API, you will need the following:

• An AWS Account - The IMDb API is exclusively available through AWS Data Exchange and requires an AWS account to access GraphQL-backed API products. To create an AWS Account, follow the AWS instructions listed here.
• AWS Access Keys - The AWS Access Keys are long-term credentials to authenticate you, so you can perform actions in an AWS account programmatically. Access Keys come in two parts: an Access Key ID and a Secret Access Key. To find out how to create an AWS Access Key, take a look at this documentation on AWS Access Keys.
• (Optional) Enabling AWS Cost Explorer - Enabling AWS Cost Explorer is necessary to see your cost and usage of the IMDb API. To enable Cost Explorer please follow the AWS instructions listed here. You can also find more information on how to see your cost and usage here.

API Products

Subscribe to the IMDb API

Once you have satisfied the prerequisites, you can request an IMDb API trial. To do this:

1. Click the link of the API Product you would like to try out.
2. Click “Continue to subscribe”.
3. Sign into your AWS Account if prompted.
4. Review the product offer and subscription terms for accuracy and complete the subscription request by clicking “Send subscription request to provider”. Subscription requests will be processed by IMDb staff within five business days. Once approved, a notification email will be sent and the status updated under “Subscriptions requests”. Subscription details are located under “Subscriptions”.

Locate IDs and API Key

To access the API you will need the Endpoint, API Key, data-set-id, revision-id, and asset-id of your subscription. These are unique for each subscriptions.

Locating the IDs

1. Under the “Entitled Data” page, select the product you wish to access, go to the most recent revision, and then click the API asset under the revision.
2. Under the “Asset Overview” section, locate the details of the Endpoint, data-set-id, revision-id, and asset-id for the product. Make a note of these.

Locating your API Key

1. You can find your API key in an email from a member of IMDb staff.
2. Make a note of this API key.

Call the API

Now that you’re subscribed to a product on AWS Data Exchange, access to an endpoint will be granted (api-fulfill.dataexchange.us-east-1.amazonaws.com/v1) and you can begin querying IMDb data sets. Check out the Calling The API page to make some calls.