Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Easy workflow with assets. Upload or download assets, 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 methodsthe Media API. 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 assets based on free text search, or for advanced search / faceted search when you want to find assets based on search filters.

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

  • Edit single media
    Download Edit a specific asset based on ID.

  • Download single media
    Receive and download a specific asset based on idID.

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

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

  • Usage reporting
    This endpoint is used to send usage information related to a assets. 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 the media bank:

...

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

...

Click on the plus button, Create API Client.

...

Add to an description.

...

  • .

...

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

...