Retrieve a product's main themes

  • Product Information
  • Resort content
  • 1 route
How can I retrieve the main themes highlighted for a product?

Use this scenario to retrieve the main themes associated with a product. It is useful when you want to surface the resort's positioning, lifestyle promises, or highlighted content blocks in a product discovery experience.

The route returns structured thematics with titles, descriptions, images, optional child themes, and service-related information when available.

Overview

This scenario documents how to retrieve the main themes of a product with the latest available version of the thematics endpoint. The response can be reused to build editorial sections, enrich a product page, or highlight the key pillars of the resort experience.

Prerequisites

  • A valid product_id
  • A valid x-api-key
  • An accept-language header matching one of the supported locales

Expected result

At the end of this scenario, you can display the product's main themes, their descriptions, associated visuals, and supporting information in a public-facing content experience.

1

Retrieve the main themes

Mandatory

This route returns the main themes of a product together with their editorial content. It is useful when you want to display the core experience pillars of a resort, their visuals, and the supporting context on a public-facing page.

Prerequisites

  • A valid product_id, for example MPAC
  • A valid x-api-key
  • An accept-language header, for example en-US

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: en-US" \
  "https://api.clubmed.com/v2/products/MPAC/thematics"

Example answer

[
  {
    "id": "cruises_theme_golf",
    "children": ["TH_SAVOUR"],
    "type": "FOOD_AND_BEVERAGE",
    "is_specific_to_product": true,
    "title": "FOOD AND DRINK",
    "sub_title": "Discover a world of flavours",
    "description": "With dining venues available for each meal, every member of family will find exatly what they want",
    "images": [
      {
        "url": "http://image.jpg",
        "type": "COMMON"
      }
    ],
    "activity_count": {
      "on_demand": 5,
      "included_activity": 4
    }
  }
]

info: The route can return multiple thematics. Use filter, limit, and page if you need to target a subset or paginate a larger content set.

Response codes

  • 200 OK: the main product themes are returned
  • 206 Partial Content: the response was truncated by pagination
  • 400 Bad Request: a required parameter is missing or invalid
  • 404 Not Found: the product_id does not match any known product
  • 416 Requested Range Not Satisfiable: the requested range cannot be served
GET/v2/products/{product_id}/thematics
See more