Bynder Media download API

The Media download API from Bynder — 3 operation(s) for media download.

Operations 3

GET /api/v4/media/{id}/download Retrieve asset download location #
GET /api/v4/media/{id}/{version}/download Retrieve asset version download location #
GET /api/v4/media/{id}/download/{itemId} Retrieve specific asset item download location #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/bynder-media-download-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bynder-media-download-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Media download API
  version: 1.0.0
servers:
- url: https://{your-bynder-domain}/
security:
- OAuth2:
  - MEDIAHIGHRES
  - ARCHIVEDOWNLOAD
  - DOWNLOADWATERMARK
  - KEYVISUALSDOWNLOAD
- permanentToken:
  - MEDIAHIGHRES
  - ARCHIVEDOWNLOAD
  - DOWNLOADWATERMARK
  - KEYVISUALSDOWNLOAD
tags:
- name: Media download
  description: ''
paths:
  /api/v4/media/{id}/download:
    get:
      summary: Retrieve asset download location
      description: 'Retrieve the download location for an asset.

        __Warning:__ Requires the MEDIAHIGHRES security role.

        __Warning:__ Requires the ARCHIVEDOWNLOAD security role if the asset in question is archived.

        __Warning:__ Requires the DOWNLOADWATERMARK security role if the asset in question is watermarked.

        __Warning:__ Requires the KEYVISUALSDOWNLOAD security role if the asset in question is marked as limited usage.'
      tags:
      - Media download
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          example: 00000000-0000-0000-0000000000000000
      - name: type
        in: query
        required: false
        schema:
          type: string
          enum:
          - original
          - additional
          default: original
      responses:
        '200':
          description: URL from which you can download the requested asset file.
          content:
            application/json:
              schema:
                type: object
                properties:
                  disclaimer:
                    type: string
                    example: <p>1. The photographs and video in the mediabank are to be used by anyone and everyone.</p>
                  s3_file:
                    type: string
                    example: ___TEMPORARY_DOWNLOAD_URL___
        '400':
          description: Invalid type
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Invalid type
                  statuscode:
                    type: string
                    example: '400'
        '404':
          description: Original file not available
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Original file not available
                  statuscode:
                    type: string
                    example: '404'
      operationId: getApiV4MediaByIdDownload
      x-operation-id-source: derived
  /api/v4/media/{id}/{version}/download:
    get:
      summary: Retrieve asset version download location
      description: 'Retrieve the download location for a specific asset version.

        __Warning:__ Requires the MEDIAHIGHRES security role.

        __Warning:__ Requires the ARCHIVEDOWNLOAD security role if the asset in question is archived.

        __Warning:__ Requires the DOWNLOADWATERMARK security role if the asset in question is watermarked.

        __Warning:__ Requires the KEYVISUALSDOWNLOAD security role if the asset in question is marked as limited usage.'
      tags:
      - Media download
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          example: 00000000-0000-0000-0000000000000000
      - name: version
        in: path
        required: true
        schema:
          type: integer
          example: '3'
      responses:
        '200':
          description: URL from which you can download the requested asset file.
          content:
            application/json:
              schema:
                type: object
                properties:
                  disclaimer:
                    type: string
                    example: <p>1. The photographs and video in the mediabank are to be used by anyone and everyone.</p>
                  s3_file:
                    type: string
                    example: ___TEMPORARY_DOWNLOAD_URL___
      operationId: getApiV4MediaByIdByVersionDownload
      x-operation-id-source: derived
  /api/v4/media/{id}/download/{itemId}:
    get:
      summary: Retrieve specific asset item download location
      description: 'Retrieve the download location for a specific asset item.

        __Warning:__ Requires the MEDIAHIGHRES security role.

        __Warning:__ Requires the ARCHIVEDOWNLOAD security role if the asset in question is archived.

        __Warning:__ Requires the DOWNLOADWATERMARK security role if the asset in question is watermarked.

        __Warning:__ Requires the KEYVISUALSDOWNLOAD security role if the asset in question is marked as limited usage.'
      tags:
      - Media download
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          example: 00000000-0000-0000-0000000000000000
      - name: itemId
        in: path
        required: true
        schema:
          type: string
          example: 00000000-0000-0000-0000000000000000
      - name: hash
        in: query
        required: false
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: URL from which you can download the requested asset file.
          content:
            application/json:
              schema:
                type: object
                properties:
                  disclaimer:
                    type: string
                    example: <p>1. The photographs and video in the mediabank are to be used by anyone and everyone.</p>
                  s3_file:
                    type: string
                    example: ___TEMPORARY_DOWNLOAD_URL___
      operationId: getApiV4MediaByIdDownloadByItemId
      x-operation-id-source: derived
components:
  securitySchemes:
    permanentToken:
      type: apiKey
      in: header
      name: Authorization
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
          scopes:
            MEDIAHIGHRES: ''
            ARCHIVEDOWNLOAD: ''
            DOWNLOADWATERMARK: ''
            KEYVISUALSDOWNLOAD: ''
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
          scopes:
            MEDIAHIGHRES: ''
            ARCHIVEDOWNLOAD: ''
            DOWNLOADWATERMARK: ''
            KEYVISUALSDOWNLOAD: ''