---
uuid: c1569c1a-4289-4e3d-a5b8-75c42f828a5f
date_created: 2026-02-26T16:41:35.164Z
date_updated: 2026-04-04T10:12:25.254Z
seo_url: resort-media
category: Resort content
routes: 
  - GET /v1/products/{product_id}/pictures
  - GET /v0/products/{product_id}/videos
---

# Retrieve resort media

This scenario explains how to retrieve the visual assets associated with a resort product so they can be reused in a product page, a destination gallery, or a promotional surface.

The flow combines the pictures endpoint and the videos endpoint to expose the main media available for the same `product_id`.

## Flow

```mermaid
flowchart LR
    step0["Retrieve resort pictures"]
    step1["Retrieve resort videos"]
    step0 --> step1
    classDef optional fill:transparent,stroke:#ffffff,color:#ffffff,stroke-width:1px,stroke-dasharray: 6\,4
    class step1 optional
```

## Overview

Use this scenario to retrieve the visual media associated with a resort product. It is useful when a digital experience needs to display hero images, gallery content, or embedded video assets on a product or destination page.

## Prerequisites

* A valid `product_id`.
* The `accept-language` and `x-api-key` headers.
* A front-end or CMS component able to reuse image URLs and video URLs returned by the API.

## Expected result

The application can retrieve the main pictures and videos of a resort product and reuse them to build visual storytelling, gallery sections, or promotional blocks.

## 1 - Retrieve resort pictures

Use `GET /v1/products/{product_id}/pictures` to retrieve the pictures associated with a resort product and expose the image assets needed by a gallery or a hero section.

#### Prerequisites

* Know a valid `product_id`.
* Send `accept-language` and `x-api-key`.
* Call this step when the experience needs still images rather than video assets.

#### Calling CURL

```bash
curl -X 'GET' \
  'https://api.clubmed.com/v1/products/{product_id}/pictures' \
  -H 'accept: application/json' \
  -H 'accept-language: en-US' \
  -H 'x-api-key: YOUR_API_KEY'
```

#### Example answer

```json
[
  {
    "url": "http://image.jpg",
    "keywords": [
      "MAIN_KEY_VISUAL"
    ]
  }
]
```

> **info:** Reuse `url` to render the image asset and `keywords` to distinguish a hero visual from other gallery pictures when your front-end supports media ranking.

***

**Response codes**

* **OK Response (200):** the pictures linked to the product are returned.
* **Error (400):** the request is invalid or the `product_id` is malformed.
* **Error (401):** not documented in Swagger.
* **Error (403):** access to the product pictures is forbidden in the current context.
* **Error (404):** the product is unknown or cannot be found.

**Related route**: [GET https://api.clubmed.com//v1/products/{product\_id}/pictures](https://api.clubmed.com/doc?search=GET%20%2Fv1%2Fproducts%2F%7Bproduct_id%7D%2Fpictures)

## 2 - Retrieve resort videos

Use `GET /v0/products/{product_id}/videos` to retrieve the video URLs associated with a resort product and complement the image assets returned by the pictures route.

#### Prerequisites

* Know a valid `product_id`.
* Send `accept-language` and `x-api-key`.
* Call this step when the experience needs playable video content in addition to still images.

#### Calling CURL

```bash
curl -X 'GET' \
  'https://api.clubmed.com/v0/products/{product_id}/videos' \
  -H 'accept: application/json' \
  -H 'accept-language: en-US' \
  -H 'x-api-key: YOUR_API_KEY'
```

#### Example answer

```json
[
  "http://image.jpg"
]
```

> **info:** The route returns direct video URLs. Reuse them to embed a player, enrich a hero block, or complete a resort gallery with motion content.

***

**Response codes**

* **OK Response (200):** the video URLs linked to the product are returned.
* **Error (400):** the request is invalid or the `product_id` is malformed.
* **Error (401):** not documented in Swagger.
* **Error (404):** the product is unknown or cannot be found.

**Related route**: [GET https://api.clubmed.com//v0/products/{product\_id}/videos](https://api.clubmed.com/doc?search=GET%20%2Fv0%2Fproducts%2F%7Bproduct_id%7D%2Fvideos)