Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Next »

Get to know the API together with it’s capabilities and read how to connect.

Easy workflow with media files. Upload or download media files, perform faceted search or search for media, retrieve individual media, edit medias or send information about media usage.

Our API usage guide will explain the basic process of interacting with these methods. Once you've figured that out, dive into the list of available methods. For further information take a look at the API documentation.

Media API’s:

  • Search media
    Use this endpoint when you want to find and browse media based on free text search, or for advanced search / faceted search when you want to find media based on search filters.

  • Get single media
    This endpoint delivers a specific media based on id.

  • Download a media file
    Receive and download a specific media based on id.

  • Download multiple media as a zip archive
    Receive and download multiple media files.

  • Upload singel media
    Use this endpoint to upload a specific media.

  • Usage reporting
    This endpoint is used to send usage information related to a media file. One will assume that the time of publication is when data is submitted trough this endpoint.

  • Search for facets
    This endpoint returns the facets you can search among.

  • Get a facet by name
    The endpoint returns all facets / search filters in a particular facet group / category.

Endpoints in this API requires authentication. To access this API, you need to get an authentication token from NTB and add it to your HTTP requests as a Bearer token. To create a token, you must have the administrator role or higher.

Create a token in NTB Mediebank

  1. Go to organization settings and form there go to API Clients.

  2. Click on the plus button, Create API Client.

  3. Add to an description.

  4. Save your client id and client secret.


Here is a guide on how to get started: Getting started with M2M authentication in NTB

  • No labels