Feeds

The Feeds endpoint provides you with JSON files of your ParOne feeds. These endpoints provide you with the fastest access to all the pertinent information about the videos in a fed, and are the fastest and most reliable way to get information about your videos.

You can integrate feeds seamlessly, using predefined categories, tags, and event-based groupings to enhance content distribution without additional processing.

Note

For real-time filtering, search, or dynamic content updates, use the Videos API instead.

Note

The JSON files are updated when a feed is updated. Be aware that you should use normal HTTP caching semantics. You can use the etag or last-modified headers to check for cache invalidation.

Endpoints

List Available Feeds

GET https://static.parone.io/v2/orgs/[orgKey]/feeds.json

This endpoint returns a list of all feeds available to your organization. The [orgKey] in the feed list URL should be replaced with your organization’s sync key.

{
  "feeds": [
    {
      "feed_id": "example-feed",
      "name": "Example Feed",
    }
  ]
}

List Videos in Feed

GET https://static.parone.io/v2/feeds/[feedID]/videos.json

Returns all video metadata for a specific feed. The [feedID] in the URL should be replaced with the specific feed’s feedID.

{
  "videos": [
    {
      "categories": [],
      "contentKey": "ca98a75f",
      "createdDate": "2023-12-01T23:40:02.044Z",
      "customFields": [],
      "description": "Video 5",
      "duration": "62",
      "events": [],
      "isLive": false,
      "paroneCategories": [
        "Editorial / Tour News / Tour Highlights",
        "Asian Tour"
      ],
      "publishedDate": "2023-12-01T23:40:02.044Z",
      "tags": [],
      "thumbnail": "https://thumbnails.parone.io/ca98a75f.jpg",
      "title": "Video 5",
      "url": "https://ingest.parone.io/ca98a75f-1080.mp4",
      "urlHLS": "https://cdn.parone.io/ca98a75f/ca98a75f.m3u8",
      "subtitles": [
        {
          "en": "https://captions.parone.io/ca98a75f/en.vtt"
        }
      ]
    }
  ]
}

List Feed Metadata

GET https://static.parone.io/v2/feeds/[feedID]/metadata.json

Retrieves the configuration metadata for a specific feed, including its settings and structure. The [feedID] in the metadata and videos URLs should be replaced with the specific feedID.

{
  "feed_id": "example-feed",
  "name": "Example Feed",
  "configuration": {
    "categories": ["sports", "golf"],
    "tags": ["instructional", "beginner"],
    "events": ["tournament-2024"]
  }
}

Structure of the Returned Results

Field	Value
contentKey	A unique identifier assigned to each video.
createdDate	The date and time when the video was first created in the system.
publishedDate	The date and time when the video was published and made available to users.
title	The official title of the video.
description	A brief summary or overview of the video’s content.
duration	The total runtime of the video in seconds.
paroneCategories	The syndicated categories assigned to the video within the ParOne system.
categories	Keywords or labels that help describe and categorize the video.
tags	Keywords or labels that the video has tagged
events	Any relevant events associated with the video, such as tournaments or special broadcasts.
customFields	A collection of additional metadata fields that may vary based on the organization’s needs.
isLive	Indicates whether the video is a live stream (true) or a pre-recorded video (false).
thumbnail	The URL of the video’s thumbnail image. See Image Optimization
url	The direct URL to download the video file.
urlHLS	The HLS (HTTP Live Streaming) URL for adaptive streaming playback.
subtitles	An array of subtitle files available for the video. The key is the language code, and the value is the URL of the subtitle file.