Introduction
ParOne is a golf media company is both a golf only content syndication platform and a hosted video player. Learn what ParOne is all about from our homepage or our press releases. This site is an overview of the ParOne documentation and all related resources.
Features
- ✅ Robust Infrastructure
- ✅ Global CDN
- ✅ Multiple SDKs and Libraries optimized for quick integration
- ✅ Built-in Ad Servers
- ✅ JSON and RSS and feed delivery
- ✅ Get Paid
Terminology
Before you get started, here’s a quick introduction to the terminalogy we use at ParOne.
Content Owners
Content Owners are organizations that create and push videos to the ParOne Network to scale the distribution of their videos to apps and websites.
Hosts
Hosts are app and websites organizations that receive content of their choosing and integrate ParOne SDKs and libraries via feeds. This enables apps and websites access to video content increasing utilization and traffic that these hosts would be otherwise unable to obtain.
Videos
Videos are created by Content Owners that contain video and other data that is sent to feeds. These videos are sent as RSS or JSON objects and contain a number of key/value pairs. Each video has a unique content-key which you use when you want to display a video in apps and wesbites. An example JSON output is displayed below:
[
{
"content-key": 193748,
"categories": [
"ParOne Tour",
"News & Tour News"
],
"description": "Highlights for the most recent stop of the ParOne Tour . Check out the team at ParOne as they build something cool.",
"end_date": "2021-12-31T00:00:00.000Z",
"geo_targets": ["GBR", "USA"],
"name": "Highlights of the ParOne Tour",
"org_logo": "https://paronecdn.com/logo.png",
"org_name": "ParOne",
"start_date": "2021-01-28T00:00:00.000Z",
"thumbnail": "https://paronecdn.com/thumbnail.jpg",
"title": "Highlights from the most recent week of the ParOne Tour",
"url": "https://paronecdn.com/video.m3u8"
}
]
Feeds
Feeds are collections of videos that apps and websites create to integrate video content their users want. Utilizing ParOne’s UI, feeds can control:
- Desired video categories
- Allowed content publishers
- Allowed sponsors
Each feed has a feed ID which you use when you want to put a video into your site/app. For information on how to create a feed, please see Create a feed.
JSON Feed Fields and Values
For reference, here are what the names of the fields in the JSON feed are, their types, and what they mean.
Field Name | Field Type | Field Value |
---|---|---|
content-key | string | The ID of the video. This is what should go in the video player’s block. |
categories | LIST of strings | The categories associated with this video |
description | string | A short description from the video. |
end_date | datetime | The date this video expires, in UTC |
start_date | datetime | The date this video starts, in UTC |
geo_targets | LIST of strings | The countries where the video can play. If it’s empty it can play anywhere. These are three-letter country codes. |
name | string | The name of the video |
thumbnail_url | URL | A URL to the poster frame/thumbnail of the video |
title | string | The video title |
url | URL | The URL of the manifest file. This will not be present in production. |