Media

Images

Format: JPG and WebP image formats are available for all asset paths.
Size: Four sizes are available per image: small, medium, large, and raw.
Browser-ready: All image sizes are optimised for web, except raw.

No hotlinking please

Images should be served from your own server. Hotlinking via the API is not supported.

Streams

3rd-party sources of streaming media are provided, where available, as an optional parameter to the Videos resource.

Source: source is either vimeo or youtube.
Source ID: sourceID values are identifiers for a source stream.
Best version: The best quality version is indicated by isPrimary.

Stream sources

{
  "sources": [
    {
      "source": "vimeo",
      "sourceId": "21054604",
      "isPrimary": 1
    },
    {
      "source": "youtube",
      "sourceId": "d-LKa1Y9_ok",
      "isPrimary": 0
    }
  ]
}

3rd-party streams only

Tiny Visions does not host or stream video content. 3rd-party video streaming sources are indicated, when available.

External resources

URLs for related resources are available as an optional parameter for the Entities resource. These resources are selected for authority, durability and persistence.

Audioculture: A NZ On Air-funded online directory for New Zealand’s popular music history.
NZ on Screen: A NZ on Air-funded online directory for NZ moving image.
Ngā Taonga Sound & Vision: A New Zealand audio-visual archive.
Discogs: The world’s largest online music database.

Albums

Albums must have at least one related music video in the Tiny Visions database to be available.

Media

Images

Format

Size

Browser-ready

Streams

Source

Source ID

Best version

External resources

Audioculture

NZ on Screen

Ngā Taonga Sound & Vision

Discogs

Albums