Embedded images

Fetch metadata and files for images embedded in the content of a work expression.

Some documents include images. The media API includes metadata for these images, and provides a mechanism to fetch the images from the API so that you can store them and serve them to your users when they view the content.

List media files for a work expression

Download a media file

PreviousCommencements NextPublication document

Last updated 10 months ago

API for fetching media files (usually images) embedded in a document.

get

/v3/{frbr_uri}/media

Authorizations

Path parameters

frbr_uristringrequired

The FRBR URI of the work or work expression, without the first slash, such as akn/za/act/1994/2/

Query parameters

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/v3/{frbr_uri}/media'

200

{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "url": "https://example.com",
      "filename": "text",
      "mime_type": "text",
      "size": 1
    }
  ]
}

Download a media file.

get

/v3/{frbr_uri}/media/{filename}