Skip to content

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>.

FieldValueComments
categoriesThe categories that the feed includes
eventsThe events that the feed includes
feed_idThe feed id, for reference
nameThe feed name, which shows up in the ParOne UI
privateCategoriesThe private categories that the feed includes
privateTagsThe private tags that the feed includes
content_keyThe content key for this videoUsed across the ParOne API to identify a piece of content.
created_dateThe date the video was createdin UTC
videosa list of videos

The list of videos has the following fields:

FieldValueComments
descriptionThe video description
categoriesThe parone categories associated with this video
privateCategoriesThe private categories associated with this video
privateTagsThe private tags associated with this video
eventsThe events associated with this video
thumbnailThe video’s thumbnail
titleThe 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

FieldValueNotes
feedThe feed ID containing the videos you want
startthe start of the results. 0 indexed
countthe 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>.

FieldValueComments
content_keyThe content key for this videoUsed across the ParOne API to identify a piece of content.
created_dateThe date the video was createdin UTC
start_date The date after which the video will be enabledin UTC
video.descriptionThe video description
categoriesThe parone categories associated with this video
video.thumbnailThe video’s thumbnail
video.titleThe video’s title
video.translationA list of Translations (see below). Each translation has a language, title, and description.
video.durationThe video duration, in seconds
total_videosThe total number of videos in the list
geosThe geographies for the video ”-” means all geos are allowed

Translations

FieldValueComments
languagetwo-letter language code
titleThe translated title of the video
descriptionThe translated description of the video