---
updatedAt: 2026-06-25T11:54:29.000Z
---

Fetch the complete documentation index at: https://developers.dailymotion.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Get a player

Load a player by `player_id`. Embed URLs and organization feature
flags are read-only. Use `fields` to trim the payload. Requires
`player.read`
[scope](https://developers.dailymotion.com/v2/reference/api-scopes).

<Callout icon="📘" theme="info">
  ### You are reading **API v2 documentation**

  Still using the Legacy API? Access the <Anchor target="_blank" href="https://developers.dailymotion.com/v0/docs/welcome">Legacy API documentation</Anchor>.
</Callout>

<br />

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Dailymotion API v2",
    "description": "The Dailymotion API v2 allows you \nto access and manage your Dailymotion content.\n",
    "version": "2.0.0"
  },
  "servers": [
    {
      "url": "https://api.dailymotion.com/v2",
      "description": "Production"
    }
  ],
  "paths": {
    "/players/{id}": {
      "get": {
        "tags": [
          "Player"
        ],
        "summary": "Get a player",
        "description": "Load a player by `player_id`. Embed URLs and organization feature\nflags are read-only. Use `fields` to trim the payload. Requires\n`player.read`\n[scope](https://developers.dailymotion.com/v2/reference/api-scopes).",
        "operationId": "getPlayer",
        "security": [
          {
            "Bearer": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Id"
            }
          },
          {
            "name": "fields",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Comma-separated field names to include. **Fields:** `advanced`, `advertising`, `appearance`, `contextual_content`, `created_at`, `display`, `embedding`, `name`, `organization_features`, `pip`, `playback`, `player_id`, `recommendation`, `updated_at`, `watermark`. For embedded objects, use dot notation (e.g. `advanced.enable_eco_mode`); **Embedded fields:** `advanced`, `advertising`, `appearance`, `contextual_content`, `display`, `embedding`, `organization_features`, `pip`, `playback`, `recommendation`, `watermark`.",
              "title": "Fields"
            },
            "description": "Comma-separated field names to include. **Fields:** `advanced`, `advertising`, `appearance`, `contextual_content`, `created_at`, `display`, `embedding`, `name`, `organization_features`, `pip`, `playback`, `player_id`, `recommendation`, `updated_at`, `watermark`. For embedded objects, use dot notation (e.g. `advanced.enable_eco_mode`); **Embedded fields:** `advanced`, `advertising`, `appearance`, `contextual_content`, `display`, `embedding`, `organization_features`, `pip`, `playback`, `recommendation`, `watermark`."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlayerGetResponse"
                }
              }
            }
          },
          "401": {
            "description": "**Authentication failed.** No ``Authorization: Bearer`` header, malformed JWT, expired passport, or invalid signature. Identity is not established—unlike **403**, the caller is not treated as an authenticated subject. Typical ``error.code`` values: ``INVALID_AUTHORIZATION``, ``AUTHORIZATION_EXPIRED``.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "AUTHORIZATION_EXPIRED",
                    "message": "Authorization expired.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "param": "authorization"
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "403": {
            "description": "**Authorization failed.** The bearer token was accepted, but the caller lacks required OAuth scopes or permissions, or an upstream service denied access to the resource. Typical ``error.code`` values: ``MISSING_PERMISSIONS``, ``UPSTREAM_ACCESS_DENIED``.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "MISSING_PERMISSIONS",
                    "message": "Missing required permissions: playlist:write. Required: playlist:read, playlist:write.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "required_permissions": [
                        "playlist:read",
                        "playlist:write"
                      ],
                      "missing_permissions": [
                        "playlist:write"
                      ]
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "404": {
            "description": "**Resource not found.** The path id does not exist, a parent resource in a nested URL is missing, or the object is not visible. Typical ``error.code``: ``RESOURCE_NOT_FOUND``.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "RESOURCE_NOT_FOUND",
                    "message": "Video with ID 'x1' not found.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "object_id": "x1",
                      "reason": "object_not_found",
                      "object_type": "Video",
                      "param": "id"
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "422": {
            "description": "**Unprocessable entity (422).** Invalid **path, query, and body parameters** (FastAPI/Pydantic). **Domain validation** (``DomainValidationError`` and subclasses). **Missing context** (e.g. ``MISSING_PARENT_ID``, ``MISSING_REQUIRED_VALUE``). All 422 responses share the same {\"error\": {\"code\", \"message\", \"correlation_id\", \"details\", \"documentation_url\"}} envelope; code and details vary by error origin.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          },
          "429": {
            "description": "**Rate limiting (reserved).** This BFF process does not currently return 429. Clients that reach the API through a gateway or CDN should still be prepared for 429 and ``Retry-After`` from those layers.",
            "content": {
              "application/json": {
                "example": {
                  "error": {
                    "code": "TOO_MANY_REQUESTS",
                    "message": "Too many requests. Retry after the indicated delay.",
                    "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
                    "details": {
                      "retry_after_seconds": 60
                    },
                    "documentation_url": "https://developers.dailymotion.com/reference/api-errors"
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/DomainErrorEnvelope"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "DomainErrorEnvelope": {
        "properties": {
          "error": {
            "$ref": "#/components/schemas/DomainErrorPayload"
          }
        },
        "type": "object",
        "required": [
          "error"
        ],
        "title": "DomainErrorEnvelope",
        "description": "Standard error body: ``{ \"error\": { ... } }``.\n\nPer-HTTP-status examples (401 vs 403 vs 404, etc.) are attached on each\nresponse in :func:`bff_api.entrypoints.api.openapi.responses.\nstandard_domain_error_responses`, not on this schema alone."
      },
      "DomainErrorPayload": {
        "properties": {
          "code": {
            "type": "string",
            "title": "Code",
            "description": "Stable machine-readable error code (e.g. RESOURCE_NOT_FOUND, MISSING_PERMISSIONS)."
          },
          "message": {
            "type": "string",
            "title": "Message",
            "description": "Human-readable summary."
          },
          "correlation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Correlation Id",
            "description": "Request correlation id for support (may be null)."
          },
          "details": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Details",
            "description": "Structured context; shape depends on *code*."
          },
          "documentation_url": {
            "type": "string",
            "title": "Documentation Url",
            "description": "Link to the public API error reference."
          }
        },
        "type": "object",
        "required": [
          "code",
          "message",
          "documentation_url"
        ],
        "title": "DomainErrorPayload",
        "description": "Fields inside the ``error`` object for non-2xx domain errors."
      },
      "PlayerAdPressureMode": {
        "type": "string",
        "enum": [
          "monetization",
          "balanced",
          "standard"
        ],
        "title": "PlayerAdPressureMode",
        "description": "Advertising pressure modes."
      },
      "PlayerAdvancedGetResponse": {
        "properties": {
          "enable_eco_mode": {
            "type": "boolean",
            "title": "Enable Eco Mode",
            "description": "Whether to enable Eco Mode to apply a quality limit. (default)",
            "example": false
          },
          "enable_receive_location_url": {
            "type": "boolean",
            "title": "Enable Receive Location Url",
            "description": "Allow player to receive full page URL where player is embedded.",
            "example": true
          },
          "enable_sharing_location_url": {
            "type": "boolean",
            "title": "Enable Sharing Location Url",
            "description": "Whether to share the location where the video is embedded \n(video URL by default).",
            "example": true
          },
          "enable_live_offair_screen": {
            "type": "boolean",
            "title": "Enable Live Offair Screen",
            "description": "Whether to display streaming status before and after live streaming.",
            "example": true
          },
          "enable_paid_partnership_label": {
            "type": "boolean",
            "title": "Enable Paid Partnership Label",
            "description": "Whether to enable the paid partnership label \n(if the playing video is flagged as such).",
            "example": false
          }
        },
        "type": "object",
        "title": "PlayerAdvancedGetResponse",
        "example": {
          "enable_eco_mode": false,
          "enable_receive_location_url": true,
          "enable_sharing_location_url": true,
          "enable_live_offair_screen": true,
          "enable_paid_partnership_label": false
        }
      },
      "PlayerAdvertisingGetResponse": {
        "properties": {
          "is_enabled": {
            "type": "boolean",
            "title": "Is Enabled",
            "description": "Whether to enable ads and associated tracking. (default)",
            "example": true
          },
          "enable_ads_controls": {
            "type": "boolean",
            "title": "Enable Ads Controls",
            "description": "Whether to display the player controls during an ad.",
            "example": true
          },
          "enable_ad_preload": {
            "type": "boolean",
            "title": "Enable Ad Preload",
            "description": "Whether to make an ad call as early as possible.",
            "example": true
          },
          "ad_pressure_mode": {
            "$ref": "#/components/schemas/PlayerAdPressureMode",
            "description": "Optimize ad pressure based on selected model: monetization, balanced,\nstandard.",
            "example": "standard"
          },
          "enable_wait_for_custom_config": {
            "type": "boolean",
            "title": "Enable Wait For Custom Config",
            "description": "Whether to configure the player to wait for the custom config object\nbefore starting playback.",
            "example": false
          },
          "wait_for_custom_config_delay": {
            "type": "integer",
            "title": "Wait For Custom Config Delay",
            "description": "How long to wait before the ad request is made (min: 1s - max: 10s),\nwhen enable_wait_for_custom_config is enabled.",
            "example": 3
          }
        },
        "type": "object",
        "title": "PlayerAdvertisingGetResponse",
        "example": {
          "is_enabled": true,
          "enable_ads_controls": true,
          "enable_ad_preload": true,
          "ad_pressure_mode": "standard",
          "enable_wait_for_custom_config": false,
          "wait_for_custom_config_delay": 3
        }
      },
      "PlayerAppearanceGetResponse": {
        "properties": {
          "color": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Color",
            "description": "Change the default highlight color used in the controls (hex without #). (default)",
            "example": "ff5500"
          },
          "aspect_ratio": {
            "$ref": "#/components/schemas/PlayerAspectRatio",
            "description": "To specify the aspect ratio of the player.",
            "example": "16:9"
          }
        },
        "type": "object",
        "title": "PlayerAppearanceGetResponse",
        "example": {
          "color": "ff5500",
          "aspect_ratio": "16:9"
        }
      },
      "PlayerAspectRatio": {
        "type": "string",
        "enum": [
          "inherit",
          "16:9",
          "4:3",
          "1:1",
          "3:4",
          "9:16"
        ],
        "title": "PlayerAspectRatio",
        "description": "Player aspect ratio values."
      },
      "PlayerAutostart": {
        "type": "string",
        "enum": [
          "off",
          "on",
          "first_time_viewable"
        ],
        "title": "PlayerAutostart",
        "description": "Player autostart values."
      },
      "PlayerContextualContentGetResponse": {
        "properties": {
          "is_enabled": {
            "type": "boolean",
            "title": "Is Enabled",
            "description": "Whether to load relevant content based on contextual information from\nthe embedder page.",
            "example": true
          },
          "source": {
            "$ref": "#/components/schemas/PlayerContextualContentSource",
            "description": "Source of the contextual content.",
            "example": "profile"
          },
          "enable_fallback": {
            "type": "boolean",
            "title": "Enable Fallback",
            "description": "Whether to allow the contextual embed feature to play less relevant\nvideos from your profile or other sources, to avoid displaying an empty \nplayer when content with high relevancy is not available.",
            "example": true
          },
          "enable_freshness": {
            "type": "boolean",
            "title": "Enable Freshness",
            "description": "Whether to activate the 'Contextual content freshness' feature.",
            "example": false
          },
          "freshness_days": {
            "type": "integer",
            "title": "Freshness Days",
            "description": "Number of days to consider\nfor the 'Contextual content freshness' feature.",
            "example": 1800
          }
        },
        "type": "object",
        "title": "PlayerContextualContentGetResponse",
        "example": {
          "is_enabled": true,
          "source": "profile",
          "enable_fallback": true,
          "enable_freshness": false,
          "freshness_days": 1800
        }
      },
      "PlayerContextualContentSource": {
        "type": "string",
        "enum": [
          "profile",
          "organization",
          "dailymotion"
        ],
        "title": "PlayerContextualContentSource",
        "description": "Contextual content source values."
      },
      "PlayerDisplayGetResponse": {
        "properties": {
          "enable_content_title": {
            "type": "boolean",
            "title": "Enable Content Title",
            "description": "Show the video title and profile info overlay. (default)",
            "example": true
          },
          "enable_dm_logo": {
            "type": "boolean",
            "title": "Enable Dm Logo",
            "description": "Show the Dailymotion logo in the player.",
            "example": true
          },
          "enable_subtitles": {
            "type": "boolean",
            "title": "Enable Subtitles",
            "description": "Show the subtitles/closed-captions toggle button.",
            "example": true
          },
          "enable_playback_controls": {
            "type": "boolean",
            "title": "Enable Playback Controls",
            "description": "Show the playback control bar (play/pause, volume, fullscreen, etc.).",
            "example": true
          },
          "enable_sharing": {
            "type": "boolean",
            "title": "Enable Sharing",
            "description": "Show the share button in the player.",
            "example": true
          },
          "enable_keyboard_shortcuts": {
            "type": "boolean",
            "title": "Enable Keyboard Shortcuts",
            "description": "Enable keyboard shortcuts (space to play/pause, arrows to seek, etc.).",
            "example": true
          },
          "enable_spinner": {
            "type": "boolean",
            "title": "Enable Spinner",
            "description": "Show the loading spinner while buffering.",
            "example": true
          },
          "enable_attention_peaks": {
            "type": "boolean",
            "title": "Enable Attention Peaks",
            "description": "Show audience attention peak indicators on the seek bar.",
            "example": false
          },
          "enable_dynamic_thumbnail": {
            "type": "boolean",
            "title": "Enable Dynamic Thumbnail",
            "description": "Whether to display animated video preview instead of a static thumbnail.",
            "example": true
          },
          "enable_profile_link": {
            "type": "boolean",
            "title": "Enable Profile Link",
            "description": "Whether to activate the link on the profile owner text.",
            "example": true
          },
          "enable_video_title_link": {
            "type": "boolean",
            "title": "Enable Video Title Link",
            "description": "Whether to activate the link on the video title text.",
            "example": true
          },
          "enable_startscreen_dm_link": {
            "type": "boolean",
            "title": "Enable Startscreen Dm Link",
            "description": "Whether to show the \"Watch on Dailymotion\" link on the startscreen.",
            "example": false
          },
          "enable_titles_in_video_cards": {
            "type": "boolean",
            "title": "Enable Titles In Video Cards",
            "description": "Whether to show the videos titles in the carousel on the endscreen.",
            "example": true
          },
          "enable_watch_now_card": {
            "type": "boolean",
            "title": "Enable Watch Now Card",
            "description": "Whether to display one video card after playback.",
            "example": false
          }
        },
        "type": "object",
        "title": "PlayerDisplayGetResponse",
        "example": {
          "enable_content_title": true,
          "enable_dm_logo": true,
          "enable_subtitles": true,
          "enable_playback_controls": true,
          "enable_sharing": true,
          "enable_keyboard_shortcuts": true,
          "enable_spinner": true,
          "enable_attention_peaks": false,
          "enable_dynamic_thumbnail": true,
          "enable_profile_link": true,
          "enable_video_title_link": true,
          "enable_startscreen_dm_link": false,
          "enable_titles_in_video_cards": true,
          "enable_watch_now_card": false
        }
      },
      "PlayerEmbeddingGetResponse": {
        "properties": {
          "html_url": {
            "type": "string",
            "title": "Html Url",
            "description": "Player HTML embed URL. (default)",
            "example": "https://geo.dailymotion.com/player/xabc123.html"
          },
          "script_url": {
            "type": "string",
            "title": "Script Url",
            "description": "URL of the player to be used in a script HTML tag.",
            "example": "https://geo.dailymotion.com/player/xabc123.js"
          },
          "library_url": {
            "type": "string",
            "title": "Library Url",
            "description": "Player library URL for SDK integration.",
            "example": "https://geo.dailymotion.com/libs/player/xabc123.js"
          }
        },
        "type": "object",
        "title": "PlayerEmbeddingGetResponse",
        "example": {
          "html_url": "https://geo.dailymotion.com/player/xabc123.html",
          "script_url": "https://geo.dailymotion.com/player/xabc123.js",
          "library_url": "https://geo.dailymotion.com/libs/player/xabc123.js"
        }
      },
      "PlayerGetResponse": {
        "properties": {
          "player_id": {
            "type": "string",
            "title": "Player Id",
            "description": "Unique identifier of the player. (default)",
            "example": "xabc123"
          },
          "name": {
            "type": "string",
            "title": "Name",
            "description": "Display name of the player. Between 1 and 255 characters. (default)",
            "example": "My Branded Player"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "ISO 8601 timestamp when the player configuration was created. (default)",
            "example": "2023-01-15T10:30:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At",
            "description": "ISO 8601 timestamp when the player configuration was last modified.",
            "example": "2023-06-01T08:00:00Z"
          },
          "embedding": {
            "$ref": "#/components/schemas/PlayerEmbeddingGetResponse",
            "description": "Read-only embed URLs (HTML, script, library) for this player.",
            "example": "{\"embed_url\": \"https://geo.dailymotion.com/player.html?video=x8abc\"}"
          },
          "organization_features": {
            "$ref": "#/components/schemas/PlayerOrganizationFeaturesGetResponse",
            "description": "Read-only feature flags reflecting the organization's entitlements.",
            "example": "{\"ads\": true, \"live\": true}"
          },
          "appearance": {
            "$ref": "#/components/schemas/PlayerAppearanceGetResponse",
            "description": "Visual appearance settings (color, aspect ratio).",
            "example": "{\"primary_color\": \"#000000\"}"
          },
          "playback": {
            "$ref": "#/components/schemas/PlayerPlaybackGetResponse",
            "description": "Playback behaviour settings (autostart, autonext, autoskip).",
            "example": "{\"autoplay\": false}"
          },
          "display": {
            "$ref": "#/components/schemas/PlayerDisplayGetResponse",
            "description": "UI element visibility settings (info overlay, logo, subtitles,\ncontrols).",
            "example": "{\"show_title\": true}"
          },
          "advertising": {
            "$ref": "#/components/schemas/PlayerAdvertisingGetResponse",
            "description": "Advertising and monetization settings.",
            "example": "{\"ad_strategy\": \"standard\"}"
          },
          "recommendation": {
            "$ref": "#/components/schemas/PlayerRecommendationGetResponse",
            "description": "Content recommendation settings.",
            "example": "{\"enabled\": true}"
          },
          "pip": {
            "$ref": "#/components/schemas/PlayerPipGetResponse",
            "description": "Picture-in-Picture (PiP) settings.",
            "example": "{\"enabled\": true}"
          },
          "watermark": {
            "$ref": "#/components/schemas/PlayerWatermarkGetResponse",
            "description": "Watermark overlay settings.",
            "example": "{\"enabled\": false}"
          },
          "contextual_content": {
            "$ref": "#/components/schemas/PlayerContextualContentGetResponse",
            "description": "Contextual content recommendation settings.",
            "example": "{\"enabled\": true}"
          },
          "advanced": {
            "$ref": "#/components/schemas/PlayerAdvancedGetResponse",
            "description": "Advanced player options (eco mode, sharing, live off-air screen).",
            "example": "{\"eco_mode\": false}"
          }
        },
        "type": "object",
        "title": "PlayerGetResponse",
        "example": {
          "player_id": "xabc123",
          "name": "My Branded Player",
          "created_at": "2023-01-15T10:30:00Z",
          "updated_at": "2023-06-01T08:00:00Z",
          "embedding": {
            "html_url": "https://geo.dailymotion.com/player/xabc123.html",
            "script_url": "https://geo.dailymotion.com/player/xabc123.js",
            "library_url": "https://geo.dailymotion.com/libs/player/xabc123.js"
          },
          "organization_features": {
            "has_ssai": false,
            "has_reached_playback_limits": false,
            "has_recommendations_from_org_only": false
          },
          "appearance": {
            "color": "ff5500",
            "aspect_ratio": "16:9"
          },
          "playback": {
            "autostart": "on",
            "enable_autonext": true,
            "enable_autoskip": false,
            "autoskip_after": 15,
            "enable_click_to_unmute": true,
            "enable_tap_to_unmute": true
          },
          "display": {
            "enable_content_title": true,
            "enable_dm_logo": true,
            "enable_subtitles": true,
            "enable_playback_controls": true,
            "enable_sharing": true,
            "enable_keyboard_shortcuts": true,
            "enable_spinner": true,
            "enable_attention_peaks": false,
            "enable_dynamic_thumbnail": true,
            "enable_profile_link": true,
            "enable_video_title_link": true,
            "enable_startscreen_dm_link": false,
            "enable_titles_in_video_cards": true,
            "enable_watch_now_card": false
          },
          "advertising": {
            "is_enabled": true,
            "enable_ads_controls": true,
            "enable_ad_preload": true,
            "ad_pressure_mode": "standard",
            "enable_wait_for_custom_config": false,
            "wait_for_custom_config_delay": 3
          },
          "recommendation": {
            "enable_auto_recommendation": true,
            "enable_custom_recommendation": false,
            "mode": "engagement"
          },
          "pip": {
            "is_enabled": "on",
            "selected_placement": "bottom_right",
            "enable_pip_placement": true,
            "enable_start_pip_expanded": false,
            "enable_legacy_pip": false,
            "enable_google_policy_ui": false
          },
          "watermark": {
            "image_type": "from_profile",
            "link_type": "from_profile",
            "link_url": "https://www.example.com"
          },
          "contextual_content": {
            "is_enabled": true,
            "source": "profile",
            "enable_fallback": true,
            "enable_freshness": false,
            "freshness_days": 1800
          },
          "advanced": {
            "enable_eco_mode": false,
            "enable_receive_location_url": true,
            "enable_sharing_location_url": true,
            "enable_live_offair_screen": true,
            "enable_paid_partnership_label": false
          }
        }
      },
      "PlayerOrganizationFeaturesGetResponse": {
        "properties": {
          "has_ssai": {
            "type": "boolean",
            "title": "Has Ssai",
            "description": "Whether the organization that owns the player has SSAI enabled. (default)",
            "example": false
          },
          "has_reached_playback_limits": {
            "type": "boolean",
            "title": "Has Reached Playback Limits",
            "description": "Whether the organization that owns the player has reached some limits\n(bandwidth, plays).",
            "example": false
          },
          "has_recommendations_from_org_only": {
            "type": "boolean",
            "title": "Has Recommendations From Org Only",
            "description": "Whether the organization that owns the player includes only videos from \nthis organization in recommendations.",
            "example": false
          }
        },
        "type": "object",
        "title": "PlayerOrganizationFeaturesGetResponse",
        "example": {
          "has_ssai": false,
          "has_reached_playback_limits": false,
          "has_recommendations_from_org_only": false
        }
      },
      "PlayerPipEnabled": {
        "type": "string",
        "enum": [
          "instant",
          "on",
          "off"
        ],
        "title": "PlayerPipEnabled",
        "description": "Picture-in-picture enablement modes."
      },
      "PlayerPipGetResponse": {
        "properties": {
          "is_enabled": {
            "$ref": "#/components/schemas/PlayerPipEnabled",
            "description": "Picture-in-Picture enablement mode. (default)",
            "example": "on"
          },
          "selected_placement": {
            "$ref": "#/components/schemas/PlayerPipPlacement",
            "description": "Define the webpage corner where PiP is initialized.",
            "example": "bottom_right"
          },
          "enable_pip_placement": {
            "type": "boolean",
            "title": "Enable Pip Placement",
            "description": "Whether to choose the webpage corner where PiP is initialized. \nIf used, overwrites PiP CSS customization.",
            "example": true
          },
          "enable_start_pip_expanded": {
            "type": "boolean",
            "title": "Enable Start Pip Expanded",
            "description": "Whether to start PiP in expanded mode on mobile\n(if legacy PiP is enabled).",
            "example": false
          },
          "enable_legacy_pip": {
            "type": "boolean",
            "title": "Enable Legacy Pip",
            "description": "When enabled, player displays the legacy PiP version.",
            "example": false
          },
          "enable_google_policy_ui": {
            "type": "boolean",
            "title": "Enable Google Policy Ui",
            "description": "Whether to enable the Google Policy UI.",
            "example": false
          }
        },
        "type": "object",
        "title": "PlayerPipGetResponse",
        "example": {
          "is_enabled": "on",
          "selected_placement": "bottom_right",
          "enable_pip_placement": true,
          "enable_start_pip_expanded": false,
          "enable_legacy_pip": false,
          "enable_google_policy_ui": false
        }
      },
      "PlayerPipPlacement": {
        "type": "string",
        "enum": [
          "bottom_right",
          "bottom_left",
          "top_right",
          "top_left"
        ],
        "title": "PlayerPipPlacement",
        "description": "Picture-in-picture placement values."
      },
      "PlayerPlaybackGetResponse": {
        "properties": {
          "autostart": {
            "$ref": "#/components/schemas/PlayerAutostart",
            "description": "To control how the player handles autoplay. (default)",
            "example": "on"
          },
          "enable_autonext": {
            "type": "boolean",
            "title": "Enable Autonext",
            "description": "Whether to automatically play the next video item.",
            "example": true
          },
          "enable_autoskip": {
            "type": "boolean",
            "title": "Enable Autoskip",
            "description": "Automatically skip to the next video after a countdown.",
            "example": false
          },
          "autoskip_after": {
            "type": "integer",
            "title": "Autoskip After",
            "description": "Number of seconds to wait before auto-skipping to the next video.\nMinimum 10.",
            "example": 15
          },
          "enable_click_to_unmute": {
            "type": "boolean",
            "title": "Enable Click To Unmute",
            "description": "Show a click-to-unmute overlay when the player autostarts muted. (default)",
            "example": true
          },
          "enable_tap_to_unmute": {
            "type": "boolean",
            "title": "Enable Tap To Unmute",
            "description": "Show a tap-to-unmute overlay on touch devices when muted.",
            "example": true
          }
        },
        "type": "object",
        "title": "PlayerPlaybackGetResponse",
        "example": {
          "autostart": "on",
          "enable_autonext": true,
          "enable_autoskip": false,
          "autoskip_after": 15,
          "enable_click_to_unmute": true,
          "enable_tap_to_unmute": true
        }
      },
      "PlayerRecommendationGetResponse": {
        "properties": {
          "enable_auto_recommendation": {
            "type": "boolean",
            "title": "Enable Auto Recommendation",
            "description": "Automatically show recommended videos at the end of playback. (default)",
            "example": true
          },
          "enable_custom_recommendation": {
            "type": "boolean",
            "title": "Enable Custom Recommendation",
            "description": "Use a custom recommendation feed instead of the default algorithm.",
            "example": false
          },
          "mode": {
            "$ref": "#/components/schemas/PlayerRecommendationMode",
            "description": "Optimise recommendations based on selected model: monetization,\nengagement, views.",
            "example": "engagement"
          }
        },
        "type": "object",
        "title": "PlayerRecommendationGetResponse",
        "example": {
          "enable_auto_recommendation": true,
          "enable_custom_recommendation": false,
          "mode": "engagement"
        }
      },
      "PlayerRecommendationMode": {
        "type": "string",
        "enum": [
          "views",
          "engagement",
          "monetization"
        ],
        "title": "PlayerRecommendationMode",
        "description": "Recommendation optimization modes."
      },
      "PlayerWatermarkGetResponse": {
        "properties": {
          "image_type": {
            "$ref": "#/components/schemas/PlayerWatermarkImageType",
            "description": "Image type of the watermark. (default)",
            "example": "from_profile"
          },
          "link_type": {
            "$ref": "#/components/schemas/PlayerWatermarkLinkType",
            "description": "Type of watermark link.",
            "example": "from_profile"
          },
          "link_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Link Url",
            "description": "URL of the watermark link.",
            "example": "https://www.example.com"
          }
        },
        "type": "object",
        "title": "PlayerWatermarkGetResponse",
        "example": {
          "image_type": "from_profile",
          "link_type": "from_profile",
          "link_url": "https://www.example.com"
        }
      },
      "PlayerWatermarkImageType": {
        "type": "string",
        "enum": [
          "none",
          "from_profile",
          "custom"
        ],
        "title": "PlayerWatermarkImageType",
        "description": "Watermark image source values."
      },
      "PlayerWatermarkLinkType": {
        "type": "string",
        "enum": [
          "none",
          "from_profile",
          "custom"
        ],
        "title": "PlayerWatermarkLinkType",
        "description": "Watermark link target values."
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "JWT token for authentication. Can be retrieved using https://oauth2.dailymotion.com/v1/token",
        "scheme": "bearer"
      }
    }
  },
  "tags": [
    {
      "name": "Player",
      "description": "Embeddable video player configuration.\n\nCovers appearance, playback, ads, and recommendations."
    }
  ]
}
```