Last updated 2 hours ago

Images

The Musement API does not return images directly. However, multiple endpoints contain URLs to images.

For example, the /activities/{activityUuid} endpoint contains a cover_image_url property:

{
	[...]
	"cover_image_url": "https://images-sandbox.musement.com/cover/0001/09/exclusive-guided-tour-in-milan-la-scala-duomo-square-and-galleria_header-8301.jpeg?w=540",
	[...]
}

Visiting the URL in the property will load an image:

Piazza del Duomo in Milan

Some endpoints contain multiple image URLs. The /activities/{activityUuid}/media endpoint returns an array which contains image URLs:

[
	[...]
	{
		"id": 8243,
		"title": "Exclusive Guided Tour in Milan: La Scala, Duomo Square and Galleria",
		"url": "https://images-sandbox.musement.com/default/0001/09/exclusive-guided-tour-in-milan-la-scala-duomo-square-and-galleria_header-8243.jpeg?w=750&h=500",
		"type": "image",
		"is_cover": false
	},
	{
		"id": 8244,
		"title": "Exclusive Guided Tour in Milan: La Scala, Duomo Square and Galleria",
		"url": "https://images-sandbox.musement.com/default/0001/09/exclusive-guided-tour-in-milan-la-scala-duomo-square-and-galleria_header-8244.jpeg?w=750&h=500",
		"type": "image",
		"is_cover": false
	},
	[...]
]

Note that the base URL of the images changes depending on the API environment you use.

You can use query parameters to modify the resulting image for any given URL. For example, you can apply an 80% sepia filter to an image by adding the sepia=80 query parameter and value to an image URL:

https://images-sandbox.musement.com/cover/0001/09/exclusive-guided-tour-in-milan-la-scala-duomo-square-and-galleria_header-8301.jpeg?w=540&sepia=80

Piazza del Duomo in Milan with a sepia filter

For a complete list of image parameters, please refer to IMGIX documentation.

Copyright © TUI Musement. All right reserved.