{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/getting-started/images/","matchPath":"","result":{"data":{"markdownRemark":{"html":"<h1 style=\"position:relative;\"><a href=\"#images\" aria-label=\"images permalink\" class=\"anchor before\"><svg aria-hidden=\"true\" focusable=\"false\" height=\"16\" version=\"1.1\" viewBox=\"0 0 16 16\" width=\"16\"><path fill-rule=\"evenodd\" d=\"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"></path></svg></a><div class=\"hidden-anchor\" id=\"images\"></div>Images</h1>\n<p>The Musement API does not return images directly. However, multiple endpoints contain URLs to images.</p>\n<p>For example, the <code class=\"language-text\">/activities/{activityUuid}</code> endpoint contains a <code class=\"language-text\">cover_image_url</code> property:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"23056239344236150000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`{\n\t[...]\n\t&quot;cover_image_url&quot;: &quot;https://images-sandbox.musement.com/cover/0001/09/exclusive-guided-tour-in-milan-la-scala-duomo-square-and-galleria_header-8301.jpeg?w=540&quot;,\n\t[...]\n}`, `23056239344236150000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-23056239344236150000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"json\"><pre class=\"language-json\"><code class=\"language-json\"><span class=\"token punctuation\">{</span>\n\t<span class=\"token punctuation\">[</span>...<span class=\"token punctuation\">]</span>\n\t<span class=\"token property\">\"cover_image_url\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"https://images-sandbox.musement.com/cover/0001/09/exclusive-guided-tour-in-milan-la-scala-duomo-square-and-galleria_header-8301.jpeg?w=540\"</span><span class=\"token punctuation\">,</span>\n\t<span class=\"token punctuation\">[</span>...<span class=\"token punctuation\">]</span>\n<span class=\"token punctuation\">}</span></code></pre></div>\n      </div>\n<p>Visiting the URL in the property will load an image:</p>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 540px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 60.08771929824561%; position: relative; bottom: 0; left: 0; background-image: url('data:image/jpeg;base64,/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wgARCAAMABQDASIAAhEBAxEB/8QAFgABAQEAAAAAAAAAAAAAAAAAAAID/8QAFQEBAQAAAAAAAAAAAAAAAAAAAAH/2gAMAwEAAhADEAAAAc97WSD/xAAZEAADAAMAAAAAAAAAAAAAAAAAAQIQEiH/2gAIAQEAAQUCmuukbMQ8f//EABcRAAMBAAAAAAAAAAAAAAAAAAABERL/2gAIAQMBAT8ByiI//8QAFhEAAwAAAAAAAAAAAAAAAAAAAAES/9oACAECAQE/AaZTP//EABcQAAMBAAAAAAAAAAAAAAAAAAARIDH/2gAIAQEABj8CRs//xAAbEAABBAMAAAAAAAAAAAAAAAABABARMUFRof/aAAgBAQABPyGyZAajxlwNlRGSv//aAAwDAQACAAMAAAAQI8//xAAWEQEBAQAAAAAAAAAAAAAAAAARECH/2gAIAQMBAT8Q0SX/xAAXEQADAQAAAAAAAAAAAAAAAAAAESFh/9oACAECAQE/EJpmh//EABsQAAIDAQEBAAAAAAAAAAAAAAERACFBMVGB/9oACAEBAAE/EAJaEyfvIgFjuwXWhWoAZoLiUp4hlXsJAFcGS5//2Q=='); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"Piazza del Duomo in Milan\"\n        title=\"Piazza del Duomo in Milan\"\n        src=\"/static/1afff2f9751453363564d7cdd3625213/09d21/image_example.jpg\"\n        srcset=\"/static/1afff2f9751453363564d7cdd3625213/74752/image_example.jpg 228w,\n/static/1afff2f9751453363564d7cdd3625213/7cd9c/image_example.jpg 455w,\n/static/1afff2f9751453363564d7cdd3625213/09d21/image_example.jpg 540w\"\n        sizes=\"(max-width: 540px) 100vw, 540px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span></p>\n<p>Some endpoints contain multiple image URLs. The <code class=\"language-text\">/activities/{activityUuid}/media</code> endpoint returns an array which contains image URLs:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"99928420422842560000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`[\n\t[...]\n\t{\n\t\t&quot;id&quot;: 8243,\n\t\t&quot;title&quot;: &quot;Exclusive Guided Tour in Milan: La Scala, Duomo Square and Galleria&quot;,\n\t\t&quot;url&quot;: &quot;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&quot;,\n\t\t&quot;type&quot;: &quot;image&quot;,\n\t\t&quot;is_cover&quot;: false\n\t},\n\t{\n\t\t&quot;id&quot;: 8244,\n\t\t&quot;title&quot;: &quot;Exclusive Guided Tour in Milan: La Scala, Duomo Square and Galleria&quot;,\n\t\t&quot;url&quot;: &quot;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&quot;,\n\t\t&quot;type&quot;: &quot;image&quot;,\n\t\t&quot;is_cover&quot;: false\n\t},\n\t[...]\n]`, `99928420422842560000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-99928420422842560000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"json\"><pre class=\"language-json\"><code class=\"language-json\"><span class=\"token punctuation\">[</span>\n\t<span class=\"token punctuation\">[</span>...<span class=\"token punctuation\">]</span>\n\t<span class=\"token punctuation\">{</span>\n\t\t<span class=\"token property\">\"id\"</span><span class=\"token operator\">:</span> <span class=\"token number\">8243</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"title\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Exclusive Guided Tour in Milan: La Scala, Duomo Square and Galleria\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"url\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"https://images-sandbox.musement.com/default/0001/09/exclusive-guided-tour-in-milan-la-scala-duomo-square-and-galleria_header-8243.jpeg?w=750&amp;h=500\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"type\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"image\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"is_cover\"</span><span class=\"token operator\">:</span> <span class=\"token boolean\">false</span>\n\t<span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n\t<span class=\"token punctuation\">{</span>\n\t\t<span class=\"token property\">\"id\"</span><span class=\"token operator\">:</span> <span class=\"token number\">8244</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"title\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Exclusive Guided Tour in Milan: La Scala, Duomo Square and Galleria\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"url\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"https://images-sandbox.musement.com/default/0001/09/exclusive-guided-tour-in-milan-la-scala-duomo-square-and-galleria_header-8244.jpeg?w=750&amp;h=500\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"type\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"image\"</span><span class=\"token punctuation\">,</span>\n\t\t<span class=\"token property\">\"is_cover\"</span><span class=\"token operator\">:</span> <span class=\"token boolean\">false</span>\n\t<span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n\t<span class=\"token punctuation\">[</span>...<span class=\"token punctuation\">]</span>\n<span class=\"token punctuation\">]</span></code></pre></div>\n      </div>\n<p>Note that the base URL of the images changes depending on the API environment you use.</p>\n<p>You can use query parameters to modify the resulting image for any given URL. For example, you can apply an <em>80% sepia filter</em> to an image by adding the <code class=\"language-text\">sepia=80</code> query parameter and value to an image URL:</p>\n<div class=\"code-wrapper\">\n        <div class=\"gatsby-code-button-container\"\n             data-toaster-id=\"30564135821228876000\"\n             data-toaster-duration=\"1500\"\n             onClick=\"copyCodeToClipboard(`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`, `30564135821228876000`)\"\n        >\n          <div class=\"gatsby-code-button\" title=\"Copy the code snippet\">Copy</div>\n          <div class=\"done-indicator done-indicator-30564135821228876000\">Copied</div>\n        </div>\n        <div class=\"gatsby-highlight\" data-language=\"text\"><pre class=\"language-text\"><code class=\"language-text\">https://images-sandbox.musement.com/cover/0001/09/exclusive-guided-tour-in-milan-la-scala-duomo-square-and-galleria_header-8301.jpeg?w=540&amp;sepia=80</code></pre></div>\n      </div>\n<p><span\n      class=\"gatsby-resp-image-wrapper\"\n      style=\"position: relative; display: block; margin-left: auto; margin-right: auto; max-width: 540px; \"\n    >\n      <span\n    class=\"gatsby-resp-image-background-image\"\n    style=\"padding-bottom: 60.08771929824561%; position: relative; bottom: 0; left: 0; background-image: url('data:image/jpeg;base64,/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wgARCAAMABQDASIAAhEBAxEB/8QAFgABAQEAAAAAAAAAAAAAAAAAAAID/8QAFgEBAQEAAAAAAAAAAAAAAAAAAAID/9oADAMBAAIQAxAAAAHLe2NyD//EABkQAAMAAwAAAAAAAAAAAAAAAAABAhASIf/aAAgBAQABBQKa66RsxDx//8QAFBEBAAAAAAAAAAAAAAAAAAAAEP/aAAgBAwEBPwE//8QAFBEBAAAAAAAAAAAAAAAAAAAAEP/aAAgBAgEBPwE//8QAFxAAAwEAAAAAAAAAAAAAAAAAABEgMf/aAAgBAQAGPwJGz//EABsQAAIDAAMAAAAAAAAAAAAAAAABETFBEFGh/9oACAEBAAE/IbIxBOp+cLJdsiNZ/9oADAMBAAIAAwAAABAL7//EABURAQEAAAAAAAAAAAAAAAAAABAR/9oACAEDAQE/EIf/xAAVEQEBAAAAAAAAAAAAAAAAAAAQEf/aAAgBAgEBPxCn/8QAGhAAAwEBAQEAAAAAAAAAAAAAAREhAFExQf/aAAgBAQABPxACVCZPL5kBw9+4XJCYAZgXFp4hlX7mAKwZu//Z'); background-size: cover; display: block;\"\n  ></span>\n  <img\n        class=\"gatsby-resp-image-image\"\n        alt=\"Piazza del Duomo in Milan with a sepia filter\"\n        title=\"Piazza del Duomo in Milan with a sepia filter\"\n        src=\"/static/7c78b84e4a994c5692985566f7df5155/09d21/sepia_example.jpg\"\n        srcset=\"/static/7c78b84e4a994c5692985566f7df5155/74752/sepia_example.jpg 228w,\n/static/7c78b84e4a994c5692985566f7df5155/7cd9c/sepia_example.jpg 455w,\n/static/7c78b84e4a994c5692985566f7df5155/09d21/sepia_example.jpg 540w\"\n        sizes=\"(max-width: 540px) 100vw, 540px\"\n        style=\"width:100%;height:100%;margin:0;vertical-align:middle;position:absolute;top:0;left:0;\"\n        loading=\"lazy\"\n      />\n    </span></p>\n<p>For a complete list of image parameters, please refer to <a href=\"https://docs.imgix.com/apis/rendering\">IMGIX documentation</a>.</p>","headings":[{"value":"Images","depth":1}]},"contentItem":{"data":{"lastModified":"2025-12-18T16:31:42.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"25e3befd-ed70-5440-a858-971f688b62dd__redocly content/api/getting-started/images/","seo":{"title":"Images","description":"Learn how to access images for activities in Musement's API.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/getting-started/images.md","pageBaseUrl":"/api/getting-started/images","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Images","id":"images"}]},"data":{"title":"","redirectFrom":["/guide/overview/images/","/api/partner/general-topics/images/"],"seo":{"description":"Learn how to access images for activities in Musement's API."}},"catalogInfo":null,"link":"/api/getting-started/images/","sidebarName":"__alternative-sidebar__-data-24763-api-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}