REST API

REST API

API Endpoint Documentation.

Current Version

The current MediaHound API version is 1.3. The version is mandatory in all API requests. You specify the version in the base URL for all HTTP requests:

Copy
http
https://api.mediahound.com/1.3

For more details, visit Versions.

Schema

  • All API requests must be over HTTPS and directed to the api.mediahound.com/X.X domain (where X.X is the current version).
  • All API calls follow RESTful semantics with GET, POST, and PUT.
  • All dates and time-stamps are in Unix Time.
  • All responses from the API are in JSON format.

Parameters

  • For GET requests, parameters should be passed as HTTP query parameters.
  • For POST and PUT requests, parameters should be included in the HTTP body encoded as JSON. The Content-Type should be application/json.

Pagination

Most API requests can return large sets of data. To prevent server overload and increased response time, the API uses pagination. For more details visit Pagination.

Rate Limiting

Access to the MediaHound API is rate limited based on endpoint, user, and clients.