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 |