---
title: "Get player by multiple identifiers"
method: GET
path: "/projects/{project_id}/player/by_identifiers/{array}"
tags: ["Player"]
---

# Get player by multiple identifiers

`GET /projects/{project_id}/player/by_identifiers/{array}`

Returns player configuration and media for a content item, looked up by multiple identifiers passed as a URL-encoded JSON array.

## Path parameters

- `array` string, required

## Response `200`

OK

- PlayerModel
  - `language` string
  - `content` object[] — Content that has been filtered to published=true and status=processed. See the swagger schema for /v1/content for more information.
    - `id` string
    - `title` string, nullable
    - `type` 'auto_segment' | 'manual_segment' | 'audio_upload' — The content type
    - `body` string, nullable — Present for uploaded audio content
    - `source_id` string, nullable
    - `source_url` string, uri, nullable — URL of the source content
    - `author` string, nullable
    - `image_url` string, uri, nullable — Feature image URL for the content
    - `is_copy` boolean — True when this content is a syndicated copy of another item
    - `language` string, nullable — Locale code for the content language (for example en_GB)
    - `audio` object[]
      - `id` integer
      - `content_type` 'audio/mpeg' | 'application/x-mpegURL' — MIME type of the audio (MP3 or HLS playlist)
      - `url` string, uri — Direct URL to the audio file
      - `duration` integer — Duration of the audio in milliseconds
    - `video` object[]
      - `id` integer
      - `content_type` 'video/mp4' | 'application/x-mpegURL' — MIME type of the video (MP4 or HLS playlist)
      - `url` string, uri — Direct URL to the video file
      - `duration` integer — Duration of the video in milliseconds
    - `audio_with_intro_outro` object[] — Audio files with intro and outro included when configured
      - `id` integer
      - `content_type` 'audio/mpeg' | 'application/x-mpegURL' — MIME type of the audio (MP3 or HLS playlist)
      - `url` string, uri — Direct URL to the audio file
      - `duration` integer — Duration of the audio in milliseconds
    - `summarization` object — Summary media variants for the content
      - `audio` object[]
        - `id` integer
        - `content_type` 'audio/mpeg' | 'application/x-mpegURL' — MIME type of the audio (MP3 or HLS playlist)
        - `url` string, uri — Direct URL to the audio file
        - `duration` integer — Duration of the audio in milliseconds
      - `video` object[]
        - `id` integer
        - `content_type` 'video/mp4' | 'application/x-mpegURL' — MIME type of the video (MP4 or HLS playlist)
        - `url` string, uri — Direct URL to the video file
        - `duration` integer — Duration of the video in milliseconds
    - `segments` object[]
      - `marker` string — Custom marker for segment identification and playback control
      - `start_time` integer, nullable — Segment start time in milliseconds
      - `duration` integer, nullable — Segment duration in milliseconds
    - `ads_enabled` boolean — When true, advertisements can play in the player
    - `title_voice_id` integer, nullable — Voice override ID for title segments
    - `summary_voice_id` integer, nullable — Voice override ID for summary segments
    - `body_voice_id` integer, nullable — Voice override ID for body segments
    - `title_enabled` boolean — Whether title audio segments are enabled
    - `body_enabled` boolean — Whether body audio segments are enabled
    - `summary_enabled` boolean — Whether summary audio segments are enabled
    - `summary_title_enabled` boolean — Whether summary playback includes title segments
    - `background_track` object, nullable
      - `enabled` boolean
      - `track` object, nullable
        - `id` integer
        - `name` string
        - `custom` boolean
        - `volume` integer
        - `url` string, nullable
    - `feature_image` object, nullable
      - `url` string, uri
      - `video_settings` object
        - `enabled` boolean
        - `crop_coordinates` object
          - `16:9` number[]
          - `9:16` number[]
    - `feature_video` object, nullable
      - `url` string, uri
      - `video_settings` object
        - `enabled` boolean
        - `volume` integer
        - `crop_coordinates` object
          - `16:9` number[]
          - `9:16` number[]
  - `settings` object — Player settings for the project of the first content item. See the swagger schema for /v1/player_settings for more information.
    - `enabled` boolean
    - `player_style` 'small' | 'standard' | 'large' | 'video'
    - `player_title` string
    - `call_to_action` string
    - `image_url` string, nullable
    - `theme` 'auto' | 'dark' | 'light'
    - `dark_theme` object
      - `text_color` string
      - `background_color` string
      - `icon_color` string
      - `highlight_color` string
      - `word_highlight_color` string
    - `light_theme` object
      - `text_color` string
      - `background_color` string
      - `icon_color` string
      - `highlight_color` string
      - `word_highlight_color` string
    - `video_theme` object
      - `text_color` string
      - `background_color` string
      - `icon_color` string
    - `title_enabled` boolean
    - `image_enabled` boolean
    - `widget_style` 'none' | 'small' | 'standard' | 'large' | 'video'
    - `widget_position` 'auto' | 'left' | 'center' | 'right'
    - `segment_playback_enabled` boolean
    - `segment_highlights_enabled` boolean
    - `skip_button_style` string
    - `intro` string, nullable
    - `outro` string, nullable
    - `intro_outro_enabled` boolean
    - `download_button_enabled` boolean
    - `logo_icon_enabled` boolean
    - `analytics_enabled` boolean
    - `analytics_uuid_enabled` boolean
    - `analytics_url` string
    - `analytics_custom_url` string, nullable
    - `analytics_id` integer
    - `analytics_tag_enabled` boolean
    - `analytics_tag` string, nullable
    - `continuous_playback_mode` 'none' | 'recent'
  - `video_settings` object — Video settings for the project of the first content item. See the swagger schema for /v1/video_settings for more information.
    - `enabled` boolean
    - `logo_image_url` string, nullable
    - `logo_image_position` 'top-left' | 'top-right'
    - `background_color` string
    - `text_transform` 'none' | 'uppercase' | 'lowercase' | 'titlecase'
    - `text_background_color` string
    - `text_background_radius` number
    - `text_color` string
    - `text_secondary_color` string, nullable
    - `text_highlight_color` string, nullable
    - `text_highlight_secondary_color` string, nullable
    - `text_highlight_background_color` string
    - `text_highlight_secondary_background_color` string, nullable
    - `text_highlight_background_radius` number
    - `text_shadow` string
    - `text_highlight_shadow` string, nullable
    - `text_stroke` string
    - `text_highlight_stroke` string, nullable
    - `text_fonts` string[]
    - `text_font_size` integer
    - `text_width` number — Maximum width of text as a ratio of the frame width.
    - `text_lines` integer, nullable
    - `text_words` integer, nullable
    - `text_horizontal_align` 'start' | 'center' | 'end'
    - `text_vertical_align` 'start' | 'center' | 'end'
    - `text_horizontal_offset` number
    - `text_vertical_offset` number
    - `text_animation` 'classic' | 'reveal' | 'karaoke' | 'pop'
    - `entrance_animation` 'none' | 'fade' | 'zoom-in' | 'zoom-out' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'pop'
    - `exit_animation` 'none' | 'fade' | 'zoom-in' | 'zoom-out' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'pop'
    - `waveform_color` string
    - `content_image_enabled` boolean
    - `playback_mode` 'cycle' | 'space-evenly' | 'follow-article'
    - `cycle_time` integer
  - `playlist` object, nullable — Playlist data, if applicable for the endpoint. Endpoint /v1/player/content/{id} returns null. Endpoint /v1/player/playlist/{id} returns data of the playlist. Endpoint /v1/player/playlist returns data of the first playlist (if any). See the swagger schema for /v1/playlist for more information.
    - `id` integer
    - `title` string
    - `type` 'project' | 'manual' | 'auto'
    - `image_url` string, nullable
    - `content_limit` integer
  - `ads` object[] — Ads that have been filtered to enabled=true and time_range overlaps the current time. See the swagger schema for /v1/ads for more information.
    - `id` integer
    - `type` 'custom' | 'vast'
    - `placement` 'pre-roll' | 'mid-roll' | 'post-roll'
    - `vast_url` string, nullable
    - `title` string, nullable
    - `click_through_url` string, nullable
    - `media_url` string, nullable
    - `media` object[]
      - `id` integer
      - `content_type` string
      - `url` string
      - `duration` integer
    - `theme` 'auto' | 'dark' | 'light', nullable
    - `dark_theme` object, nullable
      - `text_color` string
      - `background_color` string
      - `icon_color` string
      - `highlight_color` string
      - `word_highlight_color` string
    - `light_theme` object, nullable
      - `text_color` string
      - `background_color` string
      - `icon_color` string
      - `highlight_color` string
      - `word_highlight_color` string
    - `video_theme` object, nullable
      - `text_color` string
      - `background_color` string
      - `icon_color` string

---

[API](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api.md) · [All operations](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beyondwords/beyondwords-rest-api/revisions/8c4bfe3e2ebd/schema)