Dailymotion API v2 Documentation

website·Indexed 19 days ago

https://developers.dailymotion.com/

Developer documentation for Dailymotion API v2, covering authentication, video uploads, metadata management, and live event scheduling. Includes guides for importing content via MRSS feeds, managing webhooks, and implementing the Web SDK for player embedding, event listening, and state retrieval. Also provides migration instructions from the Legacy API to API v2.

Tokens
115.6K
Snippets
536
Records
844
Agent score
94%

What's inside Dailymotion API v2

  1. Overview of Dailymotion Automatic Recommendations

    Automatic Recommendations is an AI-driven feature for the Dailymotion Player that generates refined video selections to show curated content without the need for manual playlists. The system first selects the most relevant content from the user's own channel inventory; if insufficient content exists, it completes the selection with high-performing 3rd party options.
  2. Overview of Dailymotion Ad Tag Macros

    Ad macros are placeholders added to VAST ad tags that dynamically insert values (tag variables) before an ad is served to the Player. These variables provide information about the content, user, or device, allowing Dailymotion to optimize ad targeting and fill rates. Implementation is typically handled by Dailymotion Account Managers who define and implement the appropriate tags in the VAST tag based on the publisher's requirements.
  3. Overview of Dailymotion API v2

    Dailymotion API v2 is the current and recommended version of the Dailymotion API. It is divided into two main functional areas: the REST API for programmatic management of assets and the Player SDKs for embedding video playback. All API calls require authentication via a valid access token.
  4. Overview of Dailymotion API v2

    Dailymotion API v2 is the current and recommended version of the API for publishers and developers. It supports video integration, content management, custom Player embedding, and audience monetization. For those using the Legacy API, separate documentation is available.
  5. Overview of Extended User IDs (EIDs) in Dailymotion Player

    Extended User IDs (EIDs) are privacy-safe user identifiers provided by approved identity partners (e.g., LiveRamp, ID5) used to improve ad addressability. The Dailymotion Player can automatically detect, read, and forward these EIDs to eligible ad requests when user consent is present. EIDs are sent in accordance with OpenRTB 2.6 specifications.
  6. Overview of out-of-the-box fullscreen for Android

    The Dailymotion Android SDK provides a built-in fullscreen implementation that handles orientation changes (Portrait, Reverse Portrait, Landscape, Reverse Landscape), native back button support, and automatic transition to landscape mode. The PlayerView controls automatically toggle the fullscreen icon state. Note that this implementation is not customizable; for custom behavior, a custom fullscreen implementation must be used.
  7. Overview of Contextual Video Matching

    Contextual video matching allows the Dailymotion Player to automatically pick and embed the most relevant videos for a page's text content. The player analyzes the page URL, titles (checking <h1>, then falling back to <h2>, <h3>, and <title>), and the general text content. These data are sent to a recommendation engine that returns relevant videos sourced from the user's Organization or profile catalog.
  8. Overview of Google MCM via Dailymotion

    Multiple Customer Management (MCM) allows publishers to access Google Ad Exchange (AdX) through authorized third-party partners like Dailymotion. By establishing a 'parent-child' relationship (where Dailymotion is the parent and the publisher is the child), publishers can access premium ad partners, receive more competitive bids on video inventories, and increase ad revenues.
  9. Understand Player Organization feature flags

    The PlayerOrganizationFeaturesGetResponse object provides metadata about the organization owning the player, specifically regarding Server-Side Ad Insertion (SSAI), playback limits (bandwidth/plays), and whether recommendations are restricted to the organization's own videos.
    {
      "has_ssai": false,
      "has_reached_playback_limits": false,
      "has_recommendations_from_org_only": false
    }
  10. Understand Ad Pods for long-form content monetization

    Ad pods are sequences of multiple advertisements played consecutively within a single ad break. They can be used in prerolls, midrolls, and postrolls. Based on the IAB VAST 3.0 standard, ad pods improve monetization by reducing latency (filling multiple slots in one call), increasing revenue through higher fill rates, coordinating ads to prevent repetition, and providing a TV-like commercial experience.
  11. Understand the ProfileListItemResponse schema

    The ProfileListItemResponse object provides detailed information about a Dailymotion profile, including its identity, display settings, social links, content defaults, and webhook configurations.
    {
      "profile_id": "x1y2z3",
      "name": "officialdailymotion",
      "display_name": "Dailymotion Official",
      "description": "Welcome to our official channel — weekly uploads.",
      "created_at": "2020-01-01T00:00:00Z",
      "can_change_name": true,
      "social_links": {
        "twitter_url": "https://x.com/mychannel",
        "instagram_url": "https://instagram.com/mychannel",
        "facebook_url": "https://facebook.com/mychannel",
        "website_url": "https://www.example.com"
      },
      "content_defaults": {
        "language": "en",
        "visibility": "public",
        "is_for_kids": false,
        "title": "Untitled broadcast",
        "description": "Thanks for watching!",
        "tags": ["news", "weekly"],
        "category": "news",
        "ai_subtitles": ["en", "fr"],
        "enable_comments": true,
        "enable_ai_chapter_generation": true,
        "geo_restriction": {
          "mode": "allow",
          "countries": ["US", "FR", "DE"]
        }
      },
      "webhook": {
        "callback_url": "https://api.example.com/v1/webhooks/dailymotion",
        "events": ["video.created", "video.published"]
      }
    }
  12. Understand the Livestream response object

    The LivestreamGetResponse object provides comprehensive details about a Dailymotion livestream, including its configuration, current status, and metadata. Key fields include:

    • Timestamps: start_at and end_at (ISO 8601) indicate when the stream is scheduled to start or end.
    • Ingest: Contains the rtmp_url and srt_url required for streaming software configuration.
    • Status: Read-only fields indicating if the stream is currently onair and the airing_at time.
    • Recording: Details on auto_record settings and current recording status.
    • Geo-restriction: Settings for mode (e.g., 'allow') and a list of countries.
    • Embedding: Controls for enable_embed and the resulting embed_url or embed_html.
    • Advertising: Read-only status of live ads, including remaining time.
    • Thumbnail: URLs for various thumbnail heights. Note: If using ?fields=thumbnail without specifying sub-fields, only h1080_url is returned.
    {
      "livestream_id": "x1y2z3",
      "title": "Live Q&A with the Dev Team",
      "livestream_url": "https://www.dailymotion.com/video/x8abc123",
      "start_at": "2023-06-15T14:30:00Z",
      "end_at": "2023-06-15T16:00:00Z",
      "ingest": {
        "rtmp_url": "rtmp://publish.dailymotion.com/publish-dm/x8abc123?auth=KEY789",
        "srt_url": "srt://publish.dailymotion.com:1234?streamid=x8abc123"
      },
      "status": {
        "onair": true,
        "airing_at": "2023-06-15T14:30:00Z"
      },
      "embedding": {
        "enable_embed": true,
        "embed_url": "https://www.dailymotion.com/embed/video/x8abc123",
        "embed_html": "<iframe src=\"https://www.dailymotion.com/embed/video/x8abc123\">"
      },
      "thumbnail": {
        "h1080_url": "https://s1.dmcdn.net/v/SomeLive/x1080-YZy.jpg",
        "default_url": "https://s1.dmcdn.net/v/SomeLive.jpg"
      }
    }