GET Videos in a feed

Many times you need to retrieve the content keys, titles, descriptions, etc for videos. This call will retrieve the videos associated with an organization’s feed and metadata about those videos.

Retrieve videos from a feed

The easiest and fastest way to get the videos in a feed is by fetching this file via HTTPS:

https://static.parone.io/FEED_ID-feed.json

Structure of the Returned Results

The content_key and feed_id are used to parameterize the <parone-video-block>.

Field	Value	Comments
categories	The categories that the feed includes
events	The events that the feed includes
feed_id	The feed id, for reference
name	The feed name, which shows up in the ParOne UI
privateCategories	The private categories that the feed includes
privateTags	The private tags that the feed includes
content_key	The content key for this video	Used across the ParOne API to identify a piece of content.
created_date	The date the video was created	in UTC
videos	a list of videos

The list of videos has the following fields:

Field	Value	Comments
description	The video description
categories	The parone categories associated with this video
privateCategories	The private categories associated with this video
privateTags	The private tags associated with this video
events	The events associated with this video
thumbnail	The video’s thumbnail
title	The video’s title

The following call is deprecated.

This GET request retrieves the videos associated with your feed.

GET https://videos-prod.parone.app/json-feed?feed=FEED_ID&start=START&count=COUNT

Call Parameters

Field	Value	Notes
feed	The feed ID containing the videos you want
start	the start of the results. 0 indexed
count	the maximum number of results to return

Return Value

This call will return a JSON object that has a list of videos for the feed. Note that the total_videos field in each entry is the total numbers of videos in the feed, which allows you to page through the videos.

[
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "8dA83cc6AEfad0F0edd1",
    "created_date": "2023-03-04T12:11:20.865Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "8dA83cc6AEfad0F0edd1",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from the third round of the HSBC Women\u2019s World Championship",
      "duration": "519",
      "id": 10990,
      "key": "8dA83cc6AEfad0F0edd1",
      "thumbnail": "https://thumbnails.parone.io/8dA83cc6AEfad0F0edd1.jpg",
      "title": "Round 3 Highlights | 2023 HSBC Women's World Championship - extended",
      "translations": []
    }
  },
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "f610E93d1C2F20287ECf",
    "created_date": "2023-03-03T18:31:21.046Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "f610E93d1C2F20287ECf",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from the second round of the HSBC Women\u2019s World Championship",
      "duration": "489",
      "id": 10987,
      "key": "f610E93d1C2F20287ECf",
      "thumbnail": "https://thumbnails.parone.io/f610E93d1C2F20287ECf.jpg",
      "title": "Second Round Highlights | 2023 HSBC Women's World Championship -  extended",
      "translations": []
    }
  },
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "7EE3F3a0bB7f8cF4Cb91",
    "created_date": "2023-03-03T18:22:25.701Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "7EE3F3a0bB7f8cF4Cb91",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from the second round of the HSBC Women\u2019s World Championship",
      "duration": "306",
      "id": 10986,
      "key": "7EE3F3a0bB7f8cF4Cb91",
      "thumbnail": "https://thumbnails.parone.io/7EE3F3a0bB7f8cF4Cb91.jpg",
      "title": "Second Round Highlights | 2023 HSBC Women's World Championship -condensed",
      "translations": []
    }
  },
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "BbA47D0cD862b7FbB70C",
    "created_date": "2023-03-03T18:21:32.557Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "BbA47D0cD862b7FbB70C",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from Nelly Korda\u2019s second round 68 at the HSBC Women\u2019s World Championship",
      "duration": "493",
      "id": 10985,
      "key": "BbA47D0cD862b7FbB70C",
      "thumbnail": "https://thumbnails.parone.io/BbA47D0cD862b7FbB70C.jpg",
      "title": "Nelly Korda Second Round Highlights | 2023 HSBC Women's World Championship",
      "translations": []
    }
  },
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "fC0cAb13AEaC4bEDF8dB",
    "created_date": "2023-03-02T13:05:35.797Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "fC0cAb13AEaC4bEDF8dB",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from the first round of the HSBC Women\u2019s World Championship",
      "duration": "285",
      "id": 10980,
      "key": "fC0cAb13AEaC4bEDF8dB",
      "thumbnail": "https://thumbnails.parone.io/fC0cAb13AEaC4bEDF8dB.jpg",
      "title": "Frist Round Highlights | 2023 HSBC Women's World Championship - condensed",
      "translations": []
    }
  },
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "BCE98ba397Ad827AaaDB",
    "created_date": "2023-03-02T13:04:49.061Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "BCE98ba397Ad827AaaDB",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from the first round of the HSBC Women\u2019s World Championship",
      "duration": "508",
      "id": 10979,
      "key": "BCE98ba397Ad827AaaDB",
      "thumbnail": "https://thumbnails.parone.io/BCE98ba397Ad827AaaDB.jpg",
      "title": "First Round Highlights | 2023 HSBC Women's World Championship - extended",
      "translations": []
    }
  },
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "CB6f55fEd426a8ACeB0a",
    "created_date": "2023-03-02T13:03:17.394Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "CB6f55fEd426a8ACeB0a",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from Nelly Korda's first round 68 at the HSBC Women\u2019s World Championship",
      "duration": "538",
      "id": 10978,
      "key": "CB6f55fEd426a8ACeB0a",
      "thumbnail": "https://thumbnails.parone.io/CB6f55fEd426a8ACeB0a.jpg",
      "title": "Nelly Korda First Round Highlights | 2023 HSBC Women's World Championship",
      "translations": []
    }
  },
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "6DE640AaDd81B2F89387",
    "created_date": "2023-03-02T13:01:35.767Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "6DE640AaDd81B2F89387",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from Atthaya Thitikul\u2019s first round at the HSBC Women\u2019s World Championship",
      "duration": "512",
      "id": 10977,
      "key": "6DE640AaDd81B2F89387",
      "thumbnail": "https://thumbnails.parone.io/6DE640AaDd81B2F89387.jpg",
      "title": "Atthaya Thitikul First Round Highlights | 2023 HSBC Women's World Championship",
      "translations": []
    }
  },
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "1ed9dA7bDEc263F1BaD0",
    "created_date": "2023-02-26T12:25:17.405Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "1ed9dA7bDEc263F1BaD0",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from the final round of the Honda LPGA Thailand",
      "duration": "517",
      "id": 10969,
      "key": "1ed9dA7bDEc263F1BaD0",
      "thumbnail": "https://thumbnails.parone.io/1ed9dA7bDEc263F1BaD0.jpg",
      "title": "Final Round Highlights | 2023 Honda LPGA Thailand",
      "translations": []
    }
  },
  {
    "categories": [
      "LPGA Tour"
    ],
    "content_key": "8d6D7Bf3FCB4a98d121A",
    "created_date": "2023-02-26T12:24:08.709Z",
    "creator_code": "lpga",
    "end_date": "2999-12-31T00:00:00.000Z",
    "geos": "-",
    "key": "8d6D7Bf3FCB4a98d121A",
    "start_date": "2020-01-02T00:00:00.000Z",
    "total_videos": 431,
    "video": {
      "description": "Watch highlights from Atthaya Thitikul's final round 68 at the Honda LPGA Thailand",
      "duration": "497",
      "id": 10968,
      "key": "8d6D7Bf3FCB4a98d121A",
      "thumbnail": "https://thumbnails.parone.io/8d6D7Bf3FCB4a98d121A.jpg",
      "title": "Atthaya Thitikul Final Round Highlights | 2023 Honda LPGA Thailand",
      "translations": []
    }
  }
]

Structure of the Returned Results

The content_key and feed_code are used to parameterize the <parone-video-block>.

Field	Value	Comments
content_key	The content key for this video	Used across the ParOne API to identify a piece of content.
created_date	The date the video was created	in UTC
start_date The date after which the video will be enabled	in UTC
video.description	The video description
categories	The parone categories associated with this video
video.thumbnail	The video’s thumbnail
video.title	The video’s title
video.translation	A list of Translations (see below). Each translation has a language, title, and description.
video.duration	The video duration, in seconds
total_videos	The total number of videos in the list
geos	The geographies for the video ”-” means all geos are allowed

Translations

Field	Value	Comments
language	two-letter language code
title	The translated title of the video
description	The translated description of the video