IMVDb is proud to announce that we're partnering with the Los Angeles Music Video Festival this year (Oct 1-7, 2017). Call for Entries is now open! Accepting submissions now through July 15!

Submit Here

Developers

IMVDb Data API Beta


The IMVDb Data API allows you to pull data from IMVDb and use it in your application. Before you get started, please read over this guidelines document which covers the basics of using the API.


Note: The 2nd version of the IMVDb API is currently in development and will be released in Fall 2017. Version 1 of the IMVDb API will only recieve bug fixes going forwards.

Registering Your App

Before you can start using the API, you'll need to get an app key by registering your application with us. It's quick and easy!

Register New App


Rate Limits

API calls are limited to 1,000 calls per minute. If you need a higher rate limit, please contact us. However, caching is preferrable over raising rate limits.


Acceptable Usage

You can use IMVDb's data for whatever you'd like in your application, as long as you do not use the data to simply build another music video database. No attribution is needed, but if you'd like to provide attribution, you can either provide a link or use one our downloadable brand assets to show the IMVDb logo.


Developer Support

Support is currently handled through email at developers@imvdb.com.


Making API Calls

All API calls are made to the IMVDb API endpoint:

https://imvdb.com/api/v1

API Headers

Here are the following headers you can send to the API. Note that only the API Key is required.

IMVDB-APP-KEY

Your App key that you receive after registering your app. This is required or else your request will be returned with a 403 error.

IMVDB-APP-KEY: {Your App Key}

Accept

By default, API results are returned as JSON, but you can also specify XML, JSONP, or PHP Serialized as the response format using the Accept header.

Accept: application/json
Accept: application/xml
Accept: application/javascript
Accept: application/vnd.php.serialized

HTTP Status Codes

The API returns the following API status codes:

Code Description
200 OK
403 Forbidden (Returned when no API key or an invalid API key is sent)
404 Not found
500 Internal Server Error

Errors

In the event that you receive a status code that indicates an error, the API will return an error string like so:

{
    "status": false,
    "error": "Invalid API Key."
}

Testing API Calls

You can play around with the API using the API Sandbox. This allows you to try out requests without needing to get an app key.