Media APIs

This APIs are for accessing media uploaded to Tickaroo. If you are looking on how to automatically add media data to liveblogs, please refer to Media.

Download original file

Downloads the original file. Can be used with any URLs that can be found in liveblogs (especially Tickaroos own imageservice: type URLs)

Request: Get /mediagw/download/[IMAGE_URL]

Path Parameters:

  • IMAGE_URL: The URL of the image as it is returned in various fields in the liveblog. Do not encode!

Response:

Returns a 302 redirect to a temporary download location of the original file. The URL in the location header is valid for 15 minutes.

Example:

Tickaroo Image URL: 
imageservice://media/organization/55684dece4b03ddac3d474c1/liveblog/gncJ3X7nAA7q6896FnnZ/encJ3XN2AA7q68966P4o/mncJ7REGAA7q68966P4t

URL To Download:
https://www.tickaroo.com/mediagw/download/imageservice://media/organization/55684dece4b03ddac3d474c1/liveblog/gncJ3X7nAA7q6896FnnZ/encJ3XN2AA7q68966P4o/mncJ7REGAA7q68966P4t

Redirects to:
https://imageservice-prod-50b6675694a940db6d000001.s3.eu-west-1.amazonaws.com/media/organization/55684dece4b03ddac3d474c1/liveblog/gncJ3X7nAA7q6896FnnZ/encJ3XN2AA7q68966P4o/mncJ7REGAA7q68966P4t?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=...

Image Service

Serves images found in liveblogs — resized, cropped and converted on the fly. Use this instead of the download API when displaying images, e.g. when rendering a liveblog with your own frontend.

Request: GET https://cdn.tickaroo.com/mediagw/image/[TRANSFORMS]/[IMAGE_URL]

Path Parameters:

  • TRANSFORMS: One or more transform segments separated by /, see below
  • IMAGE_URL: The URL of the image as it is returned in various fields in the liveblog (an imageservice:// URI or an HTTPS URL). Do not encode!

Each transform segment consists of one command plus its parameters, separated by commas.

Resize commands

Command Effect
c_fit Scale to fit within the given box, preserving aspect ratio
c_limit Like c_fit, but never enlarges beyond the original size
c_fill Scale and crop so the given box is filled exactly

Each resize command takes two of the following parameters:

  • w_<width>: target width in pixels
  • h_<height>: target height in pixels
  • ar_<ratio>: aspect ratio, either a float (ar_1.78) or in colon syntax (ar_16:9)

c_fill additionally accepts a crop gravity:

  • g_<position>: one of north, north_east, east, south_east, south, south_west, west, north_west, center (default: center)

Format commands

  • f_gif, f_jpg (alias f_jpeg), f_png, f_webp: convert the output to the given format

Limits

Output is capped at 4096 pixels per side and 8 megapixels total. Larger requests are not rejected — the result is downscaled to fit within the limits, preserving the requested aspect ratio.

Example

A 960×540 WebP, cropped to fill:

https://cdn.tickaroo.com/mediagw/image/c_fill,w_960,h_540/f_webp/imageservice://media/organization/55684dece4b03ddac3d474c1/liveblog/gncJ3X7nAA7q6896FnnZ/encJ3XN2AA7q68966P4o/mncJ7REGAA7q68966P4t