Floatplane REST API (3.10.0-c)

Download OpenAPI specification:Download

URL: https://github.com/Jman012/FloatplaneAPI/ License: MIT

Homepage: https://jman012.github.io/FloatplaneAPIDocs

This document describes the REST API layer of https://www.floatplane.com, a content creation and video streaming website created by Floatplane Media Inc. and Linus Media Group, where users can support their favorite creators via paid subscriptions in order to watch their video and livestream content in higher quality, in addition to other perks.

While this document contains stubs for all of the Floatplane APIs for this version, many are not filled out because they are related only to content creation, moderation, or administration and are not needed for regular use. These have "TODO" as the description, and are automatically removed before document generation. If you are viewing the "Trimmed" version of this document, they have been removed for brevity.

API Object Organization

Users and Creators exist on Floatplane at the highest level
- The highest-level object in Floatplane is the Creator. This is an entity, such as Linus Tech Tips, that produces media for Users.
A Creator owns one or more Subscription Plans
A User can view a Creator's Content if they are subscribed to them
A Creator publishes Content, in the form of Blog Posts
- Content is produced by Creators, and show up for subscribed Users to view when it is released. A piece of Content is meant to be generic, and may contain different types of sub-Content. Currently, the only type is a Blog Post.
- A Blog Post is the main type of Content that a Creator produces. Blog Posts are how a Creator can share text and/or media attachments with their subscribers.
A Blog Post is comprised of one or more of: video, audio, or picture Attachments
- A media Attachment may be: video, audio, picture. Attachments are a part of Blog Posts, and are in a particular order.
A Creator may also have a single Livestream
Creators also may have one or more Channels

API Flow

As of Floatplane version 4.0.13, these are the recommended endpoints to use for normal operations.

Login
1. /api/v3/auth/captcha/info - Get captcha information
2. /api/v2/auth/login - Login with username, password, and optional captcha token
3. /api/v2/auth/checkFor2faLogin - Optionally provide 2FA token to complete login
4. /api/v2/auth/logout - Logout at a later point in time
Home page
1. /api/v3/user/subscriptions - Get the user's active subscriptions
2. /api/v3/creator/info - Get more information on subscribed creators
  1. Shows a list of creators that the user can select
  2. Note that this can search and return multiple creators. The V3 version only works for a single creator at a time.
3. /api/v3/content/creator/list - Using the subscriptions, show a home page with content from all subscriptions/subscribed creators
  1. Supply all creator identifiers from the subscriptions
  2. This is be paginated
Creator page
1. /api/v3/creator/info - Get more details for the creator to display, including if livestreams are available
2. /api/v3/content/creator - Show recent content by that creator (as opposed to all subscribed creators, above)
3. /api/v2/plan/info - Show available plans the user can subscribe to for the creator
Content page
1. /api/v3/content/post - Show more detailed information about a piece of content, including text description, available attachments, metadata, interactions, etc.
2. /api/v3/content/related - List some related content for the user to watch next
3. /api/v3/comment - Load comments for the content for the user to read
  1. There are several more comment APIs to post, like, dislike, etc.
4. /api/v2/user/ban/status - Determine if the user is banned from this creator
5. /api/v3/content/{video|audio|picture|gallery} - Load the attached media for the post. This is usually video, but audio, pictures, and galleries are also available.
6. /api/v3/delivery/info - For video and audio, this is required to get the information to stream or download the content in media players
Livestream
1. /api/v3/delivery/info - Using the type "livestream" to load the livestream media in a media player
2. wss://chat.floatplane.com/sails.io/?... - To connect to the livestream chat over websocket. See https://jman012.github.io/FloatplaneAPIDocs/ for more information on the FP Async API with Websockets.
User Profile
1. /api/v3/user/self - Display username, name, email, and profile pictures

API Organization

The organization of APIs into categories in this document are reflected from the internal organization of the Floatplane website bundled code, from frontend.floatplane.com/{version}/main.js. This is in order to use the best organization from the original developers' point of view.

For instance, Floatplane's authentication endpoints are organized into Auth.v2.login(...), Auth.v2.logout(), and Auth.v3.getCaptchaInfo(). A limitation in OpenAPI is the lack of nested tagging/structure, so this document splits Auth into AuthV2 and AuthV3 to emulate the nested structure.

Rate Limiting

The Floatplane API may employ rate limiting on certain or all endpoints. If too many requests are sent by a client to the API, it will be rejected and rate-limited. This may be by IP address per endpoint in a certain unit of time, but is subject to change.

Rate-limited requests will respond with an HTTP 429 response. The content of the response may be HTML or JSON and is subject to change. The response will also have a Retry-After header, which contains the number of seconds remaining until the rate limiting will cease for the client on that endpoint.

Clients are expected to both 1) prevent too many requests from executing at a time, usually for specific endpoints, and particulay for the /api/v2/cdn/delivery and /api/v3/delivery/info endpoints, and 2) properly handle rate-limited responses by ceasing requests until the Retry-After expiration.

Notes

Note that the Floatplane API does support the use of ETags for retrieving some information, such as retrieving information about creators, users, etc. Expect an HTTP 304 if the content has not changed, and to re-use cached responses. This is useful to ease the strain on Floatplane's API server.

The date-time format used by Floatplane API is not standard ISO 8601 format. The dates/times given by Floatplane include milliseconds. Depending on your code generator, you may need to override the date-time format to something similar to yyyy-MM-dd'T'HH:mm:ss.SSSZ, for both encoding and decoding.

ActivationV2

Activate new user accounts and confirming activation via email.

Confirm Email

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Request Activation Email

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

Content type

application/json

{ }

ACP_CreatorV3

Creator management for inviting creators.

Get Creator Invite Code List

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Create Creator Invite Code

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

{ }

ACP_FAQV2

application/json

Content type

application/json

Content type

application/json

{ }

Get Moderator Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

path Parameters

user

required

string

Responses

Response samples

Content type

application/json

{ }

List Moderators Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

Content type

application/json

Content type

application/json

{ }

AuthV2

Sign up, login, 2FA, and logout. Additionally, login spoofing for administrators.

Login

Login to Floatplane with the provided username and password, retrieving the authentication/authorization cookie from the response for subsequent requests.

Request Body schema: application/json

username required	string
password required	string
captchaToken	string The Google Recaptcha v2/v3 token to verify the request. On web browsers, this is required. For mobile or TV applications, this is not required only if the User-Agent indicates so (e.g., if the User-Agent contains "CFNetwork" in its value). Otherwise, the application would have to supply a valid captcha token, which can be difficult to obtain dynamically in some scenarios. In this case, this should be undefined (no key), not null.

Responses

Request samples

Payload

Content type

application/json

{"username": "my_username",
"password": "my_password",
"captchaToken": "..."
}

Response samples

Content type

application/json

{"user": {"id": "0123456789abcdef01234567",
"username": "my_username",
"profileImage": {"width": 512,
"height": 512,
"path": "https://pbs.floatplane.com/profile_images/default/user12.png",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/profile_images/default/user12_250x250.png"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/profile_images/default/user12_100x100.png"
}
]
}
},
"needs2FA": false
}

Logout

Log out of Floatplane, invalidating the authentication/authorization cookie.

Authorizations:

CookieAuth

Responses

Response samples

Content type

text/plain

OK

Responses

Request samples

Payload

Content type

application/json

{"token": "123456"
}

Response samples

Content type

application/json

{"user": {"id": "0123456789abcdef01234567",
"username": "my_username",
"profileImage": {"width": 512,
"height": 512,
"path": "https://pbs.floatplane.com/profile_images/default/user12.png",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/profile_images/default/user12_250x250.png"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/profile_images/default/user12_100x100.png"
}
]
}
},
"needs2FA": false
}

AuthV3

Captchas information.

Get Captcha Info

Gets the site keys used for Google Recaptcha V2 and V3. These are useful when providing a captcha token when logging in or signing up.

Responses

Response samples

Content type

application/json

{"v2": {"variants": {"android": {"siteKey": "..."
},
"checkbox": {"siteKey": "..."
},
"invisible": {"siteKey": "..."
}
}
},
"v3": {"variants": {"invisible": {"siteKey": "..."
}
}
}
}

BrainTreeV2

BrainTree payment integration

Generate Client Token

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

CDNV2

Content Delivery mechanisms for Floatplane media.

Get Delivery Info

Given an video/audio attachment identifier, retrieves the information necessary to play, download, or livestream the video/audio at various quality levels.

Authorizations:

CookieAuth

query Parameters

type required	string Enum: "vod" "aod" "live" "download" Used to determine which kind of retrieval method is requested for the video. VOD = stream a Video On Demand AOD = stream Audio On Demand Live = Livestream the content Download = Download the content for the user to play later.
guid	string The GUID of the attachment for a post, retrievable from the `videoAttachments` or `audioAttachments` object. Required when `type` is `vod`, `aod`, or `download`. Note: either this or `creator` must be supplied.
creator	string The GUID of the creator for a livestream, retrievable from `CreatorModelV2.id`. Required when `type` is `live`. Note: either this or `guid` must be supplied. Note: for `vod` and `download`, including this `creator` parameter will cause an error to be returned.

Responses

Response samples

Content type

application/json

{"cdn": "https://cdn-vod-drm2.floatplane.com",
"strategy": "cdn",
"resource": {"uri": "/Videos/TViGzkuIic/{qualityLevels}.mp4/chunk.m3u8?token={qualityLevelParams.token}",
"data": {"qualityLevels": [{"name": "360",
"width": 640,
"height": 360,
"label": "360p",
"order": 0
},
{"name": "480",
"width": 854,
"height": 480,
"label": "480p",
"order": 1
},
{"name": "720",
"width": 1280,
"height": 720,
"label": "720p",
"order": 2
},
{"name": "1080",
"width": 2160,
"height": 1080,
"label": "1080p",
"order": 4
}
],
"qualityLevelParams": {"360": {"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyZXNzb3VyY2VQYXRoIjoiL1ZpZGVvcy9UVmlHemt1SWljLzM2MC5tcDQvY2h1bmsubTN1OCIsInVzZXJJZCI6IjAxMjM0NTY3ODlhYmNkZWYwMTIzNDU2NyIsImlhdCI6MTYzMzc5NzMxMSwiZXhwIjoxNjMzODE4OTExfQ.uaLzZ4wSc0jrYbjkdhuF4_UY92iWQsq2efrWUutYUvQ"
},
"480": {"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyZXNzb3VyY2VQYXRoIjoiL1ZpZGVvcy9UVmlHemt1SWljLzQ4MC5tcDQvY2h1bmsubTN1OCIsInVzZXJJZCI6IjAxMjM0NTY3ODlhYmNkZWYwMTIzNDU2NyIsImlhdCI6MTYzMzc5NzMxMSwiZXhwIjoxNjMzODE4OTExfQ.O6PHCJKcLW7ohuKj6UcMa8QGoN-vZr6xTtfXsUMRki0"
},
"720": {"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyZXNzb3VyY2VQYXRoIjoiL1ZpZGVvcy9UVmlHemt1SWljLzcyMC5tcDQvY2h1bmsubTN1OCIsInVzZXJJZCI6IjAxMjM0NTY3ODlhYmNkZWYwMTIzNDU2NyIsImlhdCI6MTYzMzc5NzMxMSwiZXhwIjoxNjMzODE4OTExfQ.lbOTTBXBjA-i9gBzm8ydFQ8fa8q07Z2vaLsYMKUp4Ik"
},
"1080": {"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyZXNzb3VyY2VQYXRoIjoiL1ZpZGVvcy9UVmlHemt1SWljLzEwODAubXA0L2NodW5rLm0zdTgiLCJ1c2VySWQiOiIwMTIzNDU2Nzg5YWJjZGVmMDEyMzQ1NjciLCJpYXQiOjE2MzM3OTczMTEsImV4cCI6MTYzMzgxODkxMX0.E-bw_gnUzKUpYeL2l-kTmj5CbwmDb519ohjf5LlLyQg"
}
}
}
}
}

DeliveryV3

Content Delivery mechanisms for Floatplane media.

Get Delivery Info

Given an video/audio attachment or livestream identifier, retrieves the information necessary to play, download, or livestream the media at various quality levels.

Authorizations:

CookieAuth

query Parameters

scenario required	string Enum: "onDemand" "download" "live" Used to determine the scenario in which to consume the media. `onDemand` = stream a Video/Audio On Demand `download` = Download the content for the user to play later. `live` = Livestream the content
entityId required	string The attachment or livestream identifier for the requested media. For video and audio, this would be from the `videoAttachments` or `audioAttachments` objects. For livestreams, this is the `liveStream.id` from the creator object.
outputKind	string Enum: "hls.mpegts" "hls.fmp4" "dash.mpegts" "dash.m4s" "flat" Use `outputKind` to ensure the right vehicle is used for your client, e.g. `outputKind=hls.fmp4` is optimal for tvOS 10+.

Responses

Response samples

Content type

application/json

Example

Example for `onDemand`

https://www.floatplane.com/api/v3/delivery/info?entityId=Lug14XXgLx&scenario=onDemand

Note that tokens are JWT tokens, but have been replaced with <token> in the examples below.

{"groups": [{"origins": [{"url": "https://cdn-vod-drm2.floatplane.com"
}
],
"variants": [{"name": "360-avc1",
"label": "360p",
"url": "/Videos/Lug14XXgLx/360.mp4/chunk.m3u8?token=<token>",
"mimeType": "application/x-mpegURL",
"order": 11016384,
"hidden": false,
"enabled": true,
"meta": {"video": {"codec": "avc1.64001e",
"codecSimple": "avc1",
"bitrate": {"average": 255886
},
"width": 640,
"height": 320,
"isHdr": false,
"fps": 29.97,
"mimeType": "video/MP2T"
},
"audio": {"codec": "mp4a.40.2",
"bitrate": {"average": 93340,
"maximum": 93340
},
"channelCount": 2,
"samplerate": 48000,
"mimeType": "video/MP2T"
}
}
},
{"name": "480-avc1",
"label": "480p",
"url": "/Videos/Lug14XXgLx/480.mp4/chunk.m3u8?token=<token>",
"mimeType": "application/x-mpegURL",
"order": 19339456,
"hidden": false,
"enabled": true,
"meta": {"video": {"codec": "avc1.64001f",
"codecSimple": "avc1",
"bitrate": {"average": 395615
},
"width": 848,
"height": 424,
"isHdr": false,
"fps": 29.97,
"mimeType": "video/MP2T"
},
"audio": {"codec": "mp4a.40.2",
"bitrate": {"average": 93340,
"maximum": 93340
},
"channelCount": 2,
"samplerate": 48000,
"mimeType": "video/MP2T"
}
}
},
{"name": "720-avc1",
"label": "720p",
"url": "/Videos/Lug14XXgLx/720.mp4/chunk.m3u8?token=<token>",
"mimeType": "application/x-mpegURL",
"order": 44112064,
"hidden": false,
"enabled": true,
"meta": {"video": {"codec": "avc1.640020",
"codecSimple": "avc1",
"bitrate": {"average": 736634
},
"width": 1280,
"height": 640,
"isHdr": false,
"fps": 29.97,
"mimeType": "video/MP2T"
},
"audio": {"codec": "mp4a.40.2",
"bitrate": {"average": 93340,
"maximum": 93340
},
"channelCount": 2,
"samplerate": 48000,
"mimeType": "video/MP2T"
}
}
},
{"name": "1080-avc1",
"label": "1080p",
"url": "/Videos/Lug14XXgLx/1080.mp4/chunk.m3u8?token=<token>",
"mimeType": "application/x-mpegURL",
"order": 99293376,
"hidden": false,
"enabled": true,
"meta": {"video": {"codec": "avc1.64002a",
"codecSimple": "avc1",
"bitrate": {"average": 1448573
},
"width": 1920,
"height": 960,
"isHdr": false,
"fps": 29.97,
"mimeType": "video/MP2T"
},
"audio": {"codec": "mp4a.40.2",
"bitrate": {"average": 93340,
"maximum": 93340
},
"channelCount": 2,
"samplerate": 48000,
"mimeType": "video/MP2T"
}
}
},
{"name": "2160-avc1",
"label": "4K",
"url": "/Videos/Lug14XXgLx/2160.mp4/chunk.m3u8?token=<token>",
"mimeType": "application/x-mpegURL",
"order": 397351104,
"hidden": false,
"enabled": true,
"meta": {"video": {"codec": "avc1.640034",
"codecSimple": "avc1",
"bitrate": {"average": 5904212
},
"width": 3840,
"height": 1920,
"isHdr": false,
"fps": 29.97,
"mimeType": "video/MP2T"
},
"audio": {"codec": "mp4a.40.2",
"bitrate": {"average": 93340,
"maximum": 93340
},
"channelCount": 2,
"samplerate": 48000,
"mimeType": "video/MP2T"
}
}
}
]
}
]
}

ConnectedAccountsV2

3rd party account management, such as Discord or LTT Forums.

Connect

TODO

Authorizations:

CookieAuth

path Parameters

site

required

string

Responses

Response samples

Content type

application/json

{ }

Callback

TODO

Authorizations:

[{"key": "ltt",
"name": "LinusTechTips",
"enabled": true,
"iconWhite": "/images/connections/ltt/white@2x.png",
"connectedAccount": null,
"connected": false,
"isAccountProvider": false
},
{"key": "discord",
"name": "Discord",
"enabled": true,
"iconWhite": "/images/connections/discord/white@2x.png",
"connectedAccount": {"id": "9a8a4140fdd2b0c15b54333a",
"remoteUserId": "012345678912345678",
"remoteUserName": "my_username#2673",
"data": {"canJoinGuilds": true
}
},
"connected": true,
"isAccountProvider": false
}
]

CreatorAdministrationV2

Creator-specific moderator management.

Add Creator Moderator

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

CreatorV2

Get and discover creators on the platform. Creator invitation and profile management.

Get Info

Retrieve detailed information on one or more creators on Floatplane.

Authorizations:

CookieAuth

query Parameters

creatorGUID

required

Array of strings[ items non-empty ]

The GUID identifer(s) of the creator(s) to be retrieved.

Responses

Response samples

Content type

application/json

[{"id": "59f94c0bdd241b70349eb72b",
"owner": "59f94c0bdd241b70349eb723",
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": "59f94c0bdd241b70349eb727",
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "First Linux Stream",
"description": "<p>chat on Twitch</p>",
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": null,
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false
}
]

Get Info By Name

Retrieve detailed information on one or more creators on Floatplane.

Authorizations:

CookieAuth

query Parameters

creatorURL

required

Array of strings[ items non-empty ]

The string identifer(s) of the creator(s) to be retrieved.

Responses

Response samples

Content type

application/json

[{"id": "59f94c0bdd241b70349eb72b",
"owner": "59f94c0bdd241b70349eb723",
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": "59f94c0bdd241b70349eb727",
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "First Linux Stream",
"description": "<p>chat on Twitch</p>",
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": null,
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false,
"socialLinks": {"instagram": "https://www.instagram.com/linustech/",
"twitter": "https://twitter.com/linustech",
"website": "https://linustechtips.com",
"facebook": "https://www.facebook.com/LinusTech",
"youtube": "https://www.youtube.com/user/LinusTechTips"
},
"discordServers": [{"id": "5baa8838d9f3aa0a83acd429",
"guildName": "LinusTechTips",
"guildIcon": "a_528743a32b33b5eb227a8405d5593473",
"inviteLink": "https://discord.gg/LTT",
"inviteMode": "link"
},
{"id": "5e34cd9a9dbb744872192895",
"guildName": "LTT Minecraft Network",
"guildIcon": "4f7f812b49196b1646bdcdb84b948c84",
"inviteLink": "https://discord.gg/VVpwBPXrMc",
"inviteMode": "link"
}
]
}
]

CreatorV3

[{"id": "59f94c0bdd241b70349eb72b",
"owner": "59f94c0bdd241b70349eb723",
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": {"id": "59f94c0bdd241b70349eb727",
"title": "Technology"
},
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "I Am Hard... [REDACTED] - WAN Show March 17, 2023",
"description": "<p>Get a 15-day free trial for unlimited backup at<a href=\"https://www.backblaze.com/landing/podcast-wan.html\" rel=\"noopener noreferrer\" target=\"_blank\"> https://www.backblaze.com/landing/podcast-wan.html</a></p><p>Try Zoho One free for 30 days with no credit card required here:<a href=\"https://www.zoho.com/one/lp/linus.html\" rel=\"noopener noreferrer\" target=\"_blank\"> https://www.zoho.com/one/lp/linus.html</a></p><p>Save 15% with our offer code WANSHOW at <a href=\"https://vessi.com/WANSHOW\" rel=\"noopener noreferrer\" target=\"_blank\">https://vessi.com/WANSHOW</a></p><p><br></p><p>Podcast Download: TBD</p>",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/754645543818842_1679099143677.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/754645543818842_1679099143677_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/754645543818842_1679099143677_1200x675.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"channel": "63fe42c309e691e4e36de93d",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": [{"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter",
"description": "- 2 Exclusives Per Week (Meet the Team, Extras, Behind the Scenes) \n- Exclusive livestreams\n- Save $10 by purchasing an annual subscription\n- Our gratitude for your support",
"price": "5.00",
"priceYearly": "50.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
},
{"id": "5e0ba6ac14e2590f760a0f0f",
"title": "LTT Supporter Plus",
"description": "- 4K Bitrate Streaming\n- 2 Exclusives Per Week (Meet the Team, Extras, Behind the Scenes) \n- Exclusive livestreams\n- Save $20 by purchasing an annual subscription\n- Our gratitude for your support",
"price": "10.00",
"priceYearly": "100.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
}
],
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false,
"defaultChannel": "63fe42c309e691e4e36de93d",
"socialLinks": {"instagram": "https://www.instagram.com/linustech",
"website": "https://linustechtips.com",
"facebook": "https://www.facebook.com/LinusTech",
"youtube": "https://www.youtube.com/user/LinusTechTips",
"twitter": "https://twitter.com/linustech"
},
"channels": [{"id": "63fe42c309e691e4e36de93d",
"creator": "59f94c0bdd241b70349eb72b",
"title": "Linus Tech Tips",
"urlname": "main",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"order": 0,
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"card": null,
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"socialLinks": { }
},
{"id": "6413534d88c13c181c3e2809",
"creator": "59f94c0bdd241b70349eb72b",
"title": "TechLinked",
"urlname": "techlinked",
"about": "News about tech + gaming culture, delivered thrice weekly.\n\nWe're also doing long-form video essays now, apparently. \n\nThe TalkLinked talk show/podcast will probably come back at some point, too!\n\nWriters: Riley Murdock, Jon Martin, James Strieb",
"order": 2,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/6413534d88c13c181c3e2809/231100243161134_1678988109632.jpeg",
"childImages": [ ]
},
"card": null,
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/6413534d88c13c181c3e2809/955526950207988_1678988110287.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135da7ce81077a8480c679",
"creator": "59f94c0bdd241b70349eb72b",
"title": "ShortCircuit",
"urlname": "shortcircuit",
"about": "What's in the box? Let's find out!\n\nOfficial channel under Linus Media Group.",
"order": 3,
"cover": {"width": 1084,
"height": 283,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135da7ce81077a8480c679/745715133852622_1678990806332.jpeg",
"childImages": [ ]
},
"card": null,
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135da7ce81077a8480c679/470304051261927_1678990806883.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135e27c773b27ff22c97eb",
"creator": "59f94c0bdd241b70349eb72b",
"title": "Techquickie",
"urlname": "techquickie",
"about": "Ever wanted to learn more about your favorite gadgets or a trending topic in tech? \n\nWith a mix of humor, cynicism, and insight, Techquickie brings you the answers to all your tech questions every Tuesday and Friday.",
"order": 5,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135e27c773b27ff22c97eb/721553790654237_1678990887992.jpeg",
"childImages": [ ]
},
"card": null,
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135e27c773b27ff22c97eb/666841640245092_1678990909616.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135e901ebaee42e258eb0b",
"creator": "59f94c0bdd241b70349eb72b",
"title": "Mac Address",
"urlname": "macaddress",
"about": "The exploration of all things Apple, from iPhones underwater to full iClouds in the sky. We want to be the channel that you come to first for an unexpected viewpoint about the devices you love.",
"order": 4,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135e901ebaee42e258eb0b/254417940627493_1678990992632.jpeg",
"childImages": [ ]
},
"card": null,
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135e901ebaee42e258eb0b/979475909700348_1678990993114.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135ed078d6262f717341b7",
"creator": "59f94c0bdd241b70349eb72b",
"title": "Channel Super Fun",
"urlname": "channelsuperfun",
"about": "Channel Super Fun is all about the name. Games, toys, and challenges. Expect to find them all here!",
"order": 6,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135ed078d6262f717341b7/881886551214964_1678991123807.jpeg",
"childImages": [ ]
},
"card": null,
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135ed078d6262f717341b7/317924815973639_1678991124672.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135f82fc76ab7f9fbdc876",
"creator": "59f94c0bdd241b70349eb72b",
"title": "They're Just Movies",
"urlname": "tajm",
"about": "Each week our small group of nerds sits down for a not-so-serious, SPOILER-FILLED, chat about the movies you love.\n\nFormerly known as Carpool Critics, we're part of Linus Media Group!",
"order": 7,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135f82fc76ab7f9fbdc876/190277198232475_1678991235439.jpeg",
"childImages": [ ]
},
"card": null,
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135f82fc76ab7f9fbdc876/570806971094170_1678991236419.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "6413623f5b12cca228a28e78",
"creator": "59f94c0bdd241b70349eb72b",
"title": "FP Exclusive",
"urlname": "fpexclusive",
"about": "wow... so empty",
"order": 1,
"cover": {"width": 1200,
"height": 313,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/072932633007415_1678991935461.jpeg",
"childImages": [ ]
},
"card": null,
"icon": {"width": 720,
"height": 720,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/069457536750544_1678991936484.jpeg",
"childImages": [{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/069457536750544_1678991936484_100x100.jpeg"
},
{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/069457536750544_1678991936484_250x250.jpeg"
}
]
},
"socialLinks": { }
}
],
"discordServers": [{"id": "5baa8838d9f3aa0a83acd429",
"guildName": "Linus Tech Tips",
"guildIcon": "803d5f745b30aba3edba719bac671660",
"inviteLink": "https://discord.gg/LTT",
"inviteMode": "link"
},
{"id": "5e34cd9a9dbb744872192895",
"guildName": "LTT Minecraft Network",
"guildIcon": "4f7f812b49196b1646bdcdb84b948c84",
"inviteLink": "https://discord.gg/VVpwBPXrMc",
"inviteMode": "link"
}
]
}
]

Discover Creators

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

List Creator Channels

Retrieves a list of channels within the given creator(s).

Authorizations:

CookieAuth

query Parameters

ids

required

Array of strings[ items non-empty ]

The ids of the creator(s) from which to search for channels.

Responses

Response samples

Content type

application/json

[{"id": "63fe42c309e691e4e36de93d",
"creator": "59f94c0bdd241b70349eb72b",
"title": "Linus Tech Tips",
"urlname": "main",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"order": 0,
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"card": {"width": 375,
"height": 500,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871.jpeg",
"childImages": [{"width": 300,
"height": 400,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871_300x400.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"socialLinks": { }
},
{"id": "6413534d88c13c181c3e2809",
"creator": "59f94c0bdd241b70349eb72b",
"title": "TechLinked",
"urlname": "techlinked",
"about": "News about tech + gaming culture, delivered thrice weekly.\n\nWe're also doing long-form video essays now, apparently. \n\nThe TalkLinked talk show/podcast will probably come back at some point, too!\n\nWriters: Riley Murdock, Jon Martin, James Strieb",
"order": 2,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/6413534d88c13c181c3e2809/231100243161134_1678988109632.jpeg",
"childImages": [ ]
},
"card": {"width": 66,
"height": 88,
"path": "https://pbs.floatplane.com/creator_cards/59f94c0bdd241b70349eb72b/6413534d88c13c181c3e2809/953298867250186_1678988110714.jpeg",
"childImages": [ ]
},
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/6413534d88c13c181c3e2809/955526950207988_1678988110287.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135da7ce81077a8480c679",
"creator": "59f94c0bdd241b70349eb72b",
"title": "ShortCircuit",
"urlname": "shortcircuit",
"about": "What's in the box? Let's find out!\n\nOfficial channel under Linus Media Group.",
"order": 3,
"cover": {"width": 1084,
"height": 283,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135da7ce81077a8480c679/745715133852622_1678990806332.jpeg",
"childImages": [ ]
},
"card": {"width": 66,
"height": 88,
"path": "https://pbs.floatplane.com/creator_cards/59f94c0bdd241b70349eb72b/64135da7ce81077a8480c679/939790311068913_1678990807440.jpeg",
"childImages": [ ]
},
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135da7ce81077a8480c679/470304051261927_1678990806883.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135e27c773b27ff22c97eb",
"creator": "59f94c0bdd241b70349eb72b",
"title": "Techquickie",
"urlname": "techquickie",
"about": "Ever wanted to learn more about your favorite gadgets or a trending topic in tech? \n\nWith a mix of humor, cynicism, and insight, Techquickie brings you the answers to all your tech questions every Tuesday and Friday.",
"order": 5,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135e27c773b27ff22c97eb/721553790654237_1678990887992.jpeg",
"childImages": [ ]
},
"card": {"width": 66,
"height": 88,
"path": "https://pbs.floatplane.com/creator_cards/59f94c0bdd241b70349eb72b/64135e27c773b27ff22c97eb/962826906389296_1678990910103.jpeg",
"childImages": [ ]
},
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135e27c773b27ff22c97eb/666841640245092_1678990909616.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135e901ebaee42e258eb0b",
"creator": "59f94c0bdd241b70349eb72b",
"title": "Mac Address",
"urlname": "macaddress",
"about": "The exploration of all things Apple, from iPhones underwater to full iClouds in the sky. We want to be the channel that you come to first for an unexpected viewpoint about the devices you love.",
"order": 4,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135e901ebaee42e258eb0b/254417940627493_1678990992632.jpeg",
"childImages": [ ]
},
"card": {"width": 66,
"height": 88,
"path": "https://pbs.floatplane.com/creator_cards/59f94c0bdd241b70349eb72b/64135e901ebaee42e258eb0b/493604923555386_1678990993708.jpeg",
"childImages": [ ]
},
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135e901ebaee42e258eb0b/979475909700348_1678990993114.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135ed078d6262f717341b7",
"creator": "59f94c0bdd241b70349eb72b",
"title": "Channel Super Fun",
"urlname": "channelsuperfun",
"about": "Channel Super Fun is all about the name. Games, toys, and challenges. Expect to find them all here!",
"order": 6,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135ed078d6262f717341b7/881886551214964_1678991123807.jpeg",
"childImages": [ ]
},
"card": {"width": 66,
"height": 88,
"path": "https://pbs.floatplane.com/creator_cards/59f94c0bdd241b70349eb72b/64135ed078d6262f717341b7/953601834319296_1678991125167.jpeg",
"childImages": [ ]
},
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135ed078d6262f717341b7/317924815973639_1678991124672.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "64135f82fc76ab7f9fbdc876",
"creator": "59f94c0bdd241b70349eb72b",
"title": "They're Just Movies",
"urlname": "tajm",
"about": "Each week our small group of nerds sits down for a not-so-serious, SPOILER-FILLED, chat about the movies you love.\n\nFormerly known as Carpool Critics, we're part of Linus Media Group!",
"order": 7,
"cover": {"width": 1080,
"height": 282,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/64135f82fc76ab7f9fbdc876/190277198232475_1678991235439.jpeg",
"childImages": [ ]
},
"card": {"width": 66,
"height": 88,
"path": "https://pbs.floatplane.com/creator_cards/59f94c0bdd241b70349eb72b/64135f82fc76ab7f9fbdc876/863827491957963_1678991237126.jpeg",
"childImages": [ ]
},
"icon": {"width": 88,
"height": 88,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/64135f82fc76ab7f9fbdc876/570806971094170_1678991236419.jpeg",
"childImages": [ ]
},
"socialLinks": { }
},
{"id": "6413623f5b12cca228a28e78",
"creator": "59f94c0bdd241b70349eb72b",
"title": "FP Exclusive",
"urlname": "fpexclusive",
"about": "wow... so empty",
"order": 1,
"cover": {"width": 1200,
"height": 313,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/072932633007415_1678991935461.jpeg",
"childImages": [ ]
},
"card": {"width": 750,
"height": 1000,
"path": "https://pbs.floatplane.com/creator_cards/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/717727609968419_1678991937240.jpeg",
"childImages": [{"width": 375,
"height": 500,
"path": "https://pbs.floatplane.com/creator_cards/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/717727609968419_1678991937240_375x500.jpeg"
},
{"width": 300,
"height": 400,
"path": "https://pbs.floatplane.com/creator_cards/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/717727609968419_1678991937240_300x400.jpeg"
}
]
},
"icon": {"width": 720,
"height": 720,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/069457536750544_1678991936484.jpeg",
"childImages": [{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/069457536750544_1678991936484_100x100.jpeg"
},
{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/6413623f5b12cca228a28e78/069457536750544_1678991936484_250x250.jpeg"
}
]
},
"socialLinks": { }
}
]

CreatorAgreementV2

Get and agree to Creator<->Floatplane agreements.

Get Agreement

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Confirm Agreement

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

Content type

application/json

{ }

Get Creator Sub Info Public

Retrieve detailed information about a creator's subscription plans and their subscriber count.

Authorizations:

CookieAuth

query Parameters

creatorId

required

string

The GUID for the creator being search.

Responses

Response samples

Content type

application/json

{"totalSubscriberCount": 19256,
"totalIncome": null,
"plans": [{"discordRoles": [{"server": "5baa8838d9f3aa0a83acd429",
"roleName": "Floatplane.com Pilot"
},
{"server": "5e34cd9a9dbb744872192895",
"roleName": "Pilot"
}
],
"createdAt": "2019-08-06T00:56:16.180Z",
"updatedAt": "2021-09-09T16:55:02.620Z",
"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"enabled": true,
"featured": true,
"description": "Includes:\n- Early access (when possible)\n- Live Streaming\n- Behind-the-scenes, cutting room floor & exclusives\n\nNOTE: Tech Quickie and TechLinked are included for now, but will move to their own Floatplane pages in the future",
"price": "5.00",
"priceYearly": "50.00",
"paymentID": 19,
"currency": "usd",
"trialPeriod": 0,
"allowGrandfatheredAccess": false,
"logo": null,
"creator": "59f94c0bdd241b70349eb72b",
"discordServers": [{"id": "5baa8838d9f3aa0a83acd429",
"guildName": "LinusTechTips",
"guildIcon": "a_528743a32b33b5eb227a8405d5593473",
"inviteLink": "https://discord.gg/LTT",
"inviteMode": "link"
},
{"id": "5e34cd9a9dbb744872192895",
"guildName": "LTT Minecraft Network",
"guildIcon": "4f7f812b49196b1646bdcdb84b948c84",
"inviteLink": "https://discord.gg/VVpwBPXrMc",
"inviteMode": "link"
}
],
"userIsSubscribed": true,
"userIsGrandfathered": false,
"enabledGlobal": true,
"interval": "month"
},
{"discordRoles": [{"server": "5baa8838d9f3aa0a83acd429",
"roleName": "Floatplane.com Pilot"
},
{"server": "5e34cd9a9dbb744872192895",
"roleName": "Pilot"
}
],
"createdAt": "2019-12-31T19:51:08.009Z",
"updatedAt": "2020-11-07T01:33:31.617Z",
"id": "5e0ba6ac14e2590f760a0f0f",
"title": "LTT Supporter Plus",
"enabled": true,
"featured": false,
"description": "You are the real MVP. \n\nYour support helps us continue to build out our team, drive up production values, run experiments that might lose money for a long time (*cough* LTX *cough*) and otherwise be the best content creators we can be.\n\nThis tier includes all the perks of the previous ones, but at floatplane's glorious high bitrate 4K!",
"price": "10.00",
"priceYearly": "100.00",
"paymentID": 66,
"currency": "usd",
"trialPeriod": 0,
"allowGrandfatheredAccess": false,
"logo": null,
"creator": "59f94c0bdd241b70349eb72b",
"discordServers": [{"id": "5baa8838d9f3aa0a83acd429",
"guildName": "LinusTechTips",
"guildIcon": "a_528743a32b33b5eb227a8405d5593473",
"inviteLink": "https://discord.gg/LTT",
"inviteMode": "link"
},
{"id": "5e34cd9a9dbb744872192895",
"guildName": "LTT Minecraft Network",
"guildIcon": "4f7f812b49196b1646bdcdb84b948c84",
"inviteLink": "https://discord.gg/VVpwBPXrMc",
"inviteMode": "link"
}
],
"userIsSubscribed": false,
"userIsGrandfathered": false,
"enabledGlobal": true,
"interval": "month"
}
]
}

CreatorSubscriptionPlanV3

Manage creator subscription plans.

Get Plans For Content

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

{"edges": [{"hostname": "edge01-na.floatplane.com",
"queryPort": 8090,
"bandwidth": 1000000000,
"allowDownload": true,
"allowStreaming": true,
"datacenter": {"countryCode": "CA",
"regionCode": "QC",
"latitude": 45.3168,
"longitude": -73.8659
}
},
{"hostname": "edge02-na.floatplane.com",
"queryPort": 8090,
"bandwidth": 500000000,
"allowDownload": true,
"allowStreaming": true,
"datacenter": {"countryCode": "CA",
"regionCode": "QC",
"latitude": 45.3168,
"longitude": -73.8659
}
},
{"hostname": "edge01-eu.floatplane.com",
"queryPort": 8090,
"bandwidth": 1000000000,
"allowDownload": false,
"allowStreaming": true,
"datacenter": {"countryCode": "FR",
"regionCode": "A",
"latitude": 48.5873,
"longitude": 7.79821
}
},
{"hostname": "edge01-au.floatplane.com",
"queryPort": 8090,
"bandwidth": 250000000,
"allowDownload": false,
"allowStreaming": true,
"datacenter": {"countryCode": "AU",
"regionCode": "NSW",
"latitude": -33.8401,
"longitude": 151.209
}
},
{"hostname": "edge1-na-south.floatplane.com",
"queryPort": 0,
"bandwidth": 1000000000,
"allowDownload": false,
"allowStreaming": true,
"datacenter": {"countryCode": "US",
"regionCode": "FL",
"latitude": 25.8124,
"longitude": -80.2401
}
},
{"hostname": "edge1-na-sv.floatplane.com",
"queryPort": 0,
"bandwidth": 1000000000,
"allowDownload": false,
"allowStreaming": true,
"datacenter": {"countryCode": "US",
"regionCode": "CA",
"latitude": 37.3387,
"longitude": -121.8914
}
},
{"hostname": "edge03-na.floatplane.com",
"queryPort": 0,
"bandwidth": 3000000000,
"allowDownload": false,
"allowStreaming": true,
"datacenter": {"countryCode": "CA",
"regionCode": "QC",
"latitude": 45.3168,
"longitude": -73.8659
}
}
],
"client": { }
}

Get Video Url Deprecated

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

FAQV2

Get FAQs.

Get Faq Sections

Retrieve a list of FAQ sections to display to the user. Each section contains one or more FAQ items. This is normally accessible from https://www.floatplane.com/support. Note that the answers to the FAQs will contain HTML.

Responses

Response samples

Content type

application/json

[{"faqs": [{"createdAt": "2019-10-03T18:45:49.157Z",
"updatedAt": "2019-12-19T22:06:01.843Z",
"id": "5d9641ddbced315cc7d9135f",
"question": "How do you get the PewPew emote? ",
"answer": "<p><span style=\"background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);\">The PewPew emote was as an account reward for users who had succesfully set up a payment method on Floatplane.com before January 1st 2019.</span></p>",
"status": "public",
"link": "g-pewpew-emote",
"order": 1,
"faqSection": "5d9641d0b3e3285cfffe44a9"
}
],
"createdAt": "2019-10-03T18:45:36.840Z",
"updatedAt": "2019-12-19T22:08:50.481Z",
"id": "5d9641d0b3e3285cfffe44a9",
"name": "General",
"description": "For general questions about Floatplane",
"status": "public",
"order": 1
},
{"faqs": [{"createdAt": "2019-10-03T18:26:28.413Z",
"updatedAt": "2020-01-28T03:23:15.918Z",
"id": "5d963d54221c575ce366b7e7",
"question": "Can you upgrade me to the LTT supporter (1080p) subscription? ",
"answer": "<p>At this time there is no difference between the two channels in regards to features that are unlocked. The only difference between the two is the price.</p>",
"status": "public",
"link": "sub-u-payment",
"order": 1,
"faqSection": "5d8d1be612c2535c9dc067d1"
}
],
"createdAt": "2019-09-26T20:13:26.431Z",
"updatedAt": "2020-01-28T03:24:33.443Z",
"id": "5d8d1be612c2535c9dc067d1",
"name": "Subscription and Payment ",
"description": "Life isn't always about money but this section is. If you have a payment or subscription issue look here.  ",
"status": "public",
"order": 2
}
]

IframeV2

Get video iframe data.

Get Video Player Deprecated

Content type

application/json

Content type

application/json

Content type

application/json

Content type

application/json

{ }

PaymentsV2

Responses

Response samples

Content type

application/json

{ }

Webhook With Subprocessor Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

path Parameters

paymentProcessor required	string
subPaymentProcessor required	string

Responses

Response samples

Content type

application/json

{ }

List Invoices

Retrieve a list of paid or unpaid subscription invoices for the user.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{"invoices": [{"id": 1234567,
"amountDue": 50,
"amountTax": 0,
"attemptCount": 0,
"currency": "usd",
"date": "2020-11-19T16:23:33.000Z",
"dateDue": null,
"periodStart": "2020-09-25T07:35:04.273Z",
"periodEnd": "2021-09-25T07:35:04.273Z",
"nextPaymentAttempt": "2020-09-25T07:35:04.273Z",
"paid": true,
"forgiven": false,
"refunded": false,
"subscriptions": [{"id": 1234567,
"subscription": 12345,
"periodStart": "2020-09-25T07:35:04.273Z",
"periodEnd": "2021-09-25T07:35:04.273Z",
"value": 50,
"amountSubtotal": 50,
"amountTotal": 50,
"amountTax": 0,
"plan": {"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"creator": {"id": "59f94c0bdd241b70349eb72b",
"title": "LinusTechTips",
"urlname": "linustechtips",
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
}
}
}
}
]
}
]
}

SocketV2

Socket subscriptions and connections.

Subscribe User Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Subscribe User By Id Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

path Parameters

id

required

string

Responses

Response samples

Content type

application/json

{ }

SocketV3

Socket subscriptions and connections.

Connect

Used in Socket.IO/WebSocket connections. See the AsyncAPI documentation for more information. This should not be used on a raw HTTP connection.

Authorizations:

CookieAuth

Responses

Response samples

{ }

Does User Have Sub Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

SubscriptionsV3

Get user subscriptions.

List User Subscriptions

Retrieve a list of all active subscriptions for the user.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

[{"startDate": "2020-09-25T07:35:04.273Z",
"endDate": "2021-09-25T07:35:04.273Z",
"paymentID": 12345,
"interval": "year",
"paymentCancelled": false,
"plan": {"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"description": "Includes:\n- Early access (when possible)\n- Live Streaming\n- Behind-the-scenes, cutting room floor & exclusives\n\nNOTE: Tech Quickie and TechLinked are included for now, but will move to their own Floatplane pages in the future",
"price": "5.00",
"priceYearly": "50.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
},
"creator": "59f94c0bdd241b70349eb72b"
}
]

Does User Have Sub Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

SupportV2

User support ticket management

Submit Support

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Get Ticket Types

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

SyncV2

Sync connections.

Connect Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Disconnect Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

Content type

application/json

{ }

UserV2

User discovery and profile management.

Info

Retrieve more detailed information about one or more users from their identifiers.

Authorizations:

CookieAuth

query Parameters

id

required

Array of strings[ items non-empty ]

The GUID identifer(s) of the user(s) to be retrieved.

Responses

Response samples

Content type

application/json

{"users": [{"id": "59f94c0bdd241b70349eb723",
"user": {"id": "59f94c0bdd241b70349eb723",
"username": "Linus",
"profileImage": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/profile_images/59f94c0bdd241b70349eb723/013264939123424_1535577174346.jpeg",
"childImages": [{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/profile_images/59f94c0bdd241b70349eb723/013264939123424_1535577174346_100x100.jpeg"
},
{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/profile_images/59f94c0bdd241b70349eb723/013264939123424_1535577174346_250x250.jpeg"
}
]
}
}
}
]
}

Self Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Get Info By Name

Retrieve more detailed information about one or more users from their usernames.

Authorizations:

CookieAuth

query Parameters

username

required

Array of strings[ items non-empty ]

The username(s) of the user(s) to be retrieved.

Responses

Response samples

Content type

application/json

{"users": [{"id": "0123456789abcdef01234567",
"user": {"id": "0123456789abcdef01234567",
"username": "my_username",
"profileImage": {"width": 512,
"height": 512,
"path": "https://pbs.floatplane.com/profile_images/default/user12.png",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/profile_images/default/user12_250x250.png"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/profile_images/default/user12_100x100.png"
}
]
},
"email": "testemail@example.com",
"displayName": "Firstname Lastname"
}
}
]
}

Responses

Response samples

Content type

application/json

false

UserV3

User discovery and profile management.

Get Activity Feed

Retrieve recent activity for a user, such as comments and other interactions they have made on posts for creators.

Authorizations:

CookieAuth

query Parameters

id

required

string

The GUID of the user being queried.

Responses

Response samples

Content type

application/json

{"activity": [{"time": "2021-10-09T08:12:51.290Z",
"comment": "This is the text of the comment being posted",
"postTitle": "TL: Facebook Does Not Care.",
"postId": "j7KjCaKrtV",
"creatorTitle": "LinusTechTips",
"creatorUrl": "linustechtips"
}
],
"visibility": "public"
}

Get External Links

Retrieve configured social media links from a user's profile.

Authorizations:

CookieAuth

query Parameters

id

required

string

The GUID of the user being searched.

Responses

Response samples

Content type

application/json

{"twitch": {"url": "https://twitch.tv/myusername",
"type": {"name": "twitch",
"displayName": "Twitch",
"hostName": "twitch.tv"
}
}
}

Update User Notification Settings

Enable or disable email or push notifications for a specific creator.

Authorizations:

CookieAuth

Request Body schema: application/json

creator required	string
property required	string Enum: "contentEmail" "contentFirebase" Use `contentEmail` for email notifications, and `contentFirebase` for push notifications.
newValue required	boolean

Responses

Request samples

Payload

Content type

application/json

{"creator": "59f94c0bdd241b70349eb72b",
"property": "contentFirebase",
"newValue": false
}

Response samples

Content type

application/json

Content type

application/json

{ }

VideoCommentInteractionsV2

Video comment interaction management.

Clear Interaction Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Set Interaction Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

Content type

application/json

{ }

PlaylistV2

Get playlists.

List Videos Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

{ }

WebhookV2

Webhook management.

Connected Account Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

path Parameters

site

required

string

Responses

Response samples

Content type

application/json

{ }

WebhookV3

Webhook management.

IVS Livestream Publish Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Livestream Publish Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

Content type

application/json

Content type

application/json

Content type

application/json

Content type

application/json

Content type

application/json

{ }

CMS_LivestreamV3

CMS Livestream information.

Get Livestream Info

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

{ }

CommentV3

Comment retrieval, posting, and interacting.

Post Comment

Post a new comment to a blog post object.

Authorizations:

CookieAuth

Request Body schema: application/json

blogPost required	string The GUID of the blogPost the comment should be posted to.
text required	string The text of the comment being posted.

Responses

Request samples

Payload

Content type

application/json

{"blogPost": "j7KjCaKrtV",
"text": "This is the text of the comment being posted"
}

Response samples

Content type

application/json

{"id": "8d575af6834343b166d0562a",
"blogPost": "j7KjCaKrtV",
"user": {"id": "0123456789abcdef01234567",
"username": "my_username",
"profileImage": {"width": 512,
"height": 512,
"path": "https://pbs.floatplane.com/profile_images/default/user12.png",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/profile_images/default/user12_250x250.png"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/profile_images/default/user12_100x100.png"
}
]
}
},
"text": "This is the text of the comment being posted",
"replying": null,
"postDate": "2021-10-09T08:12:51.290Z",
"editDate": "2021-10-09T08:12:51.290Z",
"likes": 0,
"dislikes": 0,
"score": 0,
"interactionCounts": {"like": 0,
"dislike": 0
}
}

Get Comments

Get comments for a blog post object. Note that replies to each comment tend to be limited to 3. The extra replies can be retrieved via getCommentReplies. The difference in $response.body#/0/totalReplies and $response.body#/0/replies's length can determine if more comments need to be loaded.

Authorizations:

CookieAuth

query Parameters

blogPost required	string Which blog post to retrieve comments for.
limit required	integer The maximum number of comments to return. This should be set to 20 by default.
fetchAfter	string When loading more comments on a blog post, this is used to determine which which comments to skip. This is a GUID of the last comment from the previous call to `getComments`.

Responses

Response samples

Content type

application/json

[{"id": "00c5ab7379e746b24a76634b",
"blogPost": "Dw2ms0AgL8",
"user": {"id": "ff0a479639c60f3a8cd18d8b",
"username": "some_username",
"profileImage": {"width": 512,
"height": 512,
"path": "https://pbs.floatplane.com/profile_images/default/user10.png",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/profile_images/default/user10_250x250.png"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/profile_images/default/user10_100x100.png"
}
]
}
},
"text": "This is my comment text, I really like this video.",
"replying": null,
"postDate": "2021-10-09T14:58:34.829Z",
"editDate": "2021-10-09T14:58:34.829Z",
"likes": 0,
"dislikes": 0,
"score": 0,
"interactionCounts": {"like": 0,
"dislike": 0
},
"totalReplies": 0,
"replies": [ ],
"userInteraction": null
}
]

Get Comment Replies

Retrieve more replies from a comment.

Authorizations:

CookieAuth

query Parameters

comment required	string The identifer of the comment from which to retrieve replies.
blogPost required	string The identifer of the blog post the `comment` belongs to.
limit required	integer How many replies to retrieve.
rid required	string The identifer of the last reply in the reply chain.

Responses

Response samples

Content type

application/json

[{"id": "1234567890abcdef",
"blogPost": "p3OSnFmsR3",
"user": {"id": "abcdef1234567890",
"username": "the_username",
"profileImage": {"width": 225,
"height": 225,
"path": "https://pbs.floatplane.com/profile_images/default/user12.png",
"childImages": [{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/profile_images/default/user12.png"
}
]
}
},
"text": "This is my reply text",
"replying": "1234567890abcdef0",
"postDate": "2021-12-17T06:57:33.152Z",
"editDate": "2021-12-17T06:57:33.152Z",
"likes": 0,
"dislikes": 0,
"score": 0,
"interactionCounts": {"like": 0,
"dislike": 0
},
"userInteraction": null
}
]

Like Comment

Like a comment on a blog post.

Authorizations:

CookieAuth

Request Body schema: application/json

comment required	string The GUID of the comment being liked.
blogPost required	string The GUID of the post the comment is on.

Responses

Request samples

Payload

Content type

application/json

{"comment": "6161935e24f43441325bb255",
"blogPost": "j7KjCaKrtV"
}

Response samples

Content type

text/plain

like

Dislike Comment

Dislike a comment on a blog post.

Authorizations:

CookieAuth

Request Body schema: application/json

comment required	string The GUID of the comment being liked.
blogPost required	string The GUID of the post the comment is on.

Responses

Request samples

Payload

Content type

application/json

{"comment": "6161935e24f43441325bb255",
"blogPost": "j7KjCaKrtV"
}

Response samples

Content type

text/plain

dislike

ContentV3

Content retrieval and interacting.

Get Creator Blog Posts

Retrieve a paginated list of blog posts from a creator. Or search for blog posts from a creator.

Example query: https://www.floatplane.com/api/v3/content/creator?id=59f94c0bdd241b70349eb72b&fromDate=2021-07-24T07:00:00.001Z&toDate=2022-07-27T06:59:59.099Z&hasVideo=true&hasAudio=true&hasPicture=false&hasText=false&fromDuration=1020&toDuration=9900&sort=DESC&search=thor&tags[0]=tjm

Authorizations:

CookieAuth

query Parameters

id required	string The GUID of the creator to retrieve posts from.
channel	string The id of a creator's specific channel from which to retrieve posts.
limit	integer [ 1 .. 20 ] The maximum number of posts to return.
fetchAfter	integer The number of posts to skip. Usually a multiple of `limit`, to get the next "page" of results.
search	string Search filter to look for specific posts.
tags	Array of strings[ items >= 0 items ] An array of tags to search against, possibly in addition to `search`.
hasVideo	boolean If true, include blog posts with video attachments.
hasAudio	boolean If true, include blog posts with audio attachments.
hasPicture	boolean If true, include blog posts with picture attachments.
hasText	boolean If true, only include blog posts that are text-only. Text-only posts are ones without any attachments, such as video, audio, picture, and gallery. This filter and `hasVideo`, `hasAudio`, and `hasPicture` should be mutually exclusive. That is, if `hasText` is true then the other three should all be false. Conversely, if any of the other three are true, then `hasText` should be false. Otherwise, the filter would produce no results.
sort	string Enum: "ASC" "DESC" `DESC` = Newest First. `ASC` = Oldest First.
fromDuration	integer Include video posts where the duration of the video is at minimum `fromDuration` seconds long. Usually in multiples of 60 seconds. Implies `hasVideo=true`.
toDuration	integer Include video posts where the duration of the video is at maximum `toDuration` seconds long. Usually in multiples of 60 seconds. Implies `hasVideo=true`.
fromDate	string <date-time> Example: fromDate=2022-07-24T07:00:00.001Z Include posts where the publication date is on or after this filter date.
toDate	string <date-time> Example: toDate=2022-07-24T07:00:00.001Z Include posts where the publication date is on or before this filter date.

Responses

Response samples

Content type

application/json

[{"id": "Dw2ms0AgL8",
"guid": "Dw2ms0AgL8",
"title": "Livestream VOD – October 9, 2021 @ 07:18 – First Linux Stream",
"text": "<p>chat on Twitch</p>",
"type": "blogPost",
"tags": ["test"
],
"attachmentOrder": ["TViGzkuIic"
],
"metadata": {"hasVideo": true,
"videoCount": 1,
"videoDuration": 5689,
"hasAudio": false,
"audioCount": 0,
"audioDuration": 0,
"hasPicture": false,
"pictureCount": 0,
"hasGallery": false,
"galleryCount": 0,
"isFeatured": false
},
"releaseDate": "2021-10-09T09:29:00.039Z",
"likes": 41,
"dislikes": 0,
"score": 41,
"comments": 28,
"creator": {"id": "59f94c0bdd241b70349eb72b",
"owner": {"id": "59f94c0bdd241b70349eb723",
"username": "Linus"
},
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": {"title": "Technology"
},
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "First Linux Stream",
"description": "<p>chat on Twitch</p>",
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": [{"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"description": "Includes:\n- Early access (when possible)\n- Live Streaming\n- Behind-the-scenes, cutting room floor & exclusives\n\nNOTE: Tech Quickie and TechLinked are included for now, but will move to their own Floatplane pages in the future",
"price": "5.00",
"priceYearly": "50.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
},
{"id": "5e0ba6ac14e2590f760a0f0f",
"title": "LTT Supporter Plus",
"description": "You are the real MVP. \n\nYour support helps us continue to build out our team, drive up production values, run experiments that might lose money for a long time (*cough* LTX *cough*) and otherwise be the best content creators we can be.\n\nThis tier includes all the perks of the previous ones, but at floatplane's glorious high bitrate 4K!",
"price": "10.00",
"priceYearly": "100.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": false,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
}
],
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false,
"card": {"width": 375,
"height": 500,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871.jpeg",
"childImages": [{"width": 300,
"height": 400,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871_300x400.jpeg"
}
]
}
},
"wasReleasedSilently": true,
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"isAccessible": true,
"videoAttachments": ["TViGzkuIic"
],
"audioAttachments": [ ],
"pictureAttachments": [ ],
"galleryAttachments": [ ]
},
{"id": "ge4gLGfXnz",
"guid": "ge4gLGfXnz",
"title": "Livestream VOD – October 8, 2021 @ 20:26 – I Have MORE to Say About Steam Deck - WAN Show October 8, 2021",
"text": "<p>Honey automatically applies the best coupon codes to save you money at </p><p>different online checkouts, try it now at <a href=\"https://www.joinhoney.com/linus\">https://www.joinhoney.com/linus</a></p><p><br /></p><p>Buy a Seasonic Ultra Titanium PSU</p><p>On Amazon: <a href=\"https://geni.us/q4lnefC\">https://geni.us/q4lnefC</a></p><p>On NewEgg: <a href=\"https://lmg.gg/8KV3S\">https://lmg.gg/8KV3S</a></p><p><br /></p><p>Visit <a href=\"https://www.squarespace.com/WAN\">https://www.squarespace.com/WAN</a> and use offer code WAN for 10% off</p><p><br /></p><p>Podcast Download: TBD</p><p><br /></p><p>Check out our other Podcasts:</p><p>Carpool Critics Movie Podcast: <a href=\"https://www.youtube.com/channel/UCt-oJR5teQIjOAxCmIQvcgA\">https://www.youtube.com/channel/UCt-oJR5teQIjOAxCmIQvcgA</a></p><p><br /></p><p>Timestamps TBD</p>",
"type": "blogPost",
"attachmentOrder": ["psqoN3CgMH",
"KijsTQP8Rr"
],
"metadata": {"hasVideo": true,
"videoCount": 2,
"videoDuration": 9506,
"hasAudio": false,
"audioCount": 0,
"audioDuration": 0,
"hasPicture": false,
"pictureCount": 0,
"hasGallery": false,
"galleryCount": 0,
"isFeatured": false
},
"releaseDate": "2021-10-09T09:28:00.015Z",
"likes": 43,
"dislikes": 3,
"score": 40,
"comments": 24,
"creator": {"id": "59f94c0bdd241b70349eb72b",
"owner": {"id": "59f94c0bdd241b70349eb723",
"username": "Linus"
},
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": {"title": "Technology"
},
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "First Linux Stream",
"description": "<p>chat on Twitch</p>",
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": [{"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"description": "Includes:\n- Early access (when possible)\n- Live Streaming\n- Behind-the-scenes, cutting room floor & exclusives\n\nNOTE: Tech Quickie and TechLinked are included for now, but will move to their own Floatplane pages in the future",
"price": "5.00",
"priceYearly": "50.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
},
{"id": "5e0ba6ac14e2590f760a0f0f",
"title": "LTT Supporter Plus",
"description": "You are the real MVP. \n\nYour support helps us continue to build out our team, drive up production values, run experiments that might lose money for a long time (*cough* LTX *cough*) and otherwise be the best content creators we can be.\n\nThis tier includes all the perks of the previous ones, but at floatplane's glorious high bitrate 4K!",
"price": "10.00",
"priceYearly": "100.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": false,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
}
],
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false,
"card": {"width": 375,
"height": 500,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871.jpeg",
"childImages": [{"width": 300,
"height": 400,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871_300x400.jpeg"
}
]
}
},
"wasReleasedSilently": false,
"thumbnail": {"width": 640,
"height": 360,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/ge4gLGfXnz/564833356017787_1633771544979.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/ge4gLGfXnz/564833356017787_1633771544979_400x225.jpeg"
}
]
},
"isAccessible": true,
"videoAttachments": ["KijsTQP8Rr",
"psqoN3CgMH"
],
"audioAttachments": [ ],
"pictureAttachments": [ ],
"galleryAttachments": [ ]
}
]

Get Multi Creator Blog Posts

Retrieve paginated blog posts from multiple creators for the home page.

Example query: https://www.floatplane.com/api/v3/content/creator/list?ids[0]=59f94c0bdd241b70349eb72b&limit=20&fetchAfter[0][creatorId]=59f94c0bdd241b70349eb72b&fetchAfter[0][blogPostId]=B4WsyLnybS&fetchAfter[0][moreFetchable]=true

Authorizations:

CookieAuth

query Parameters

ids required	Array of strings[ items non-empty ] The GUID(s) of the creator(s) to retrieve posts from.
limit required	integer >= 1 The maximum number of posts to retrieve.
	Array of objects (ContentCreatorListLastItems) For pagination, this is used to determine which posts to skip. There should be one `fetchAfter` object for each creator in `ids`. The `moreFetchable` in the request, and all of the data, comes from the `ContentCreatorListV3Response`.

Responses

Response samples

Content type

application/json

{"blogPosts": [{"id": "Dw2ms0AgL8",
"guid": "Dw2ms0AgL8",
"title": "Livestream VOD – October 9, 2021 @ 07:18 – First Linux Stream",
"text": "<p>chat on Twitch</p>",
"type": "blogPost",
"attachmentOrder": ["TViGzkuIic"
],
"metadata": {"hasVideo": true,
"videoCount": 1,
"videoDuration": 5689,
"hasAudio": false,
"audioCount": 0,
"audioDuration": 0,
"hasPicture": false,
"pictureCount": 0,
"hasGallery": false,
"galleryCount": 0,
"isFeatured": false
},
"releaseDate": "2021-10-09T09:29:00.039Z",
"likes": 40,
"dislikes": 0,
"score": 40,
"comments": 28,
"creator": {"id": "59f94c0bdd241b70349eb72b",
"owner": {"id": "59f94c0bdd241b70349eb723",
"username": "Linus"
},
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": {"title": "Technology"
},
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "First Linux Stream",
"description": "<p>chat on Twitch</p>",
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": [{"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"description": "Includes:\n- Early access (when possible)\n- Live Streaming\n- Behind-the-scenes, cutting room floor & exclusives\n\nNOTE: Tech Quickie and TechLinked are included for now, but will move to their own Floatplane pages in the future",
"price": "5.00",
"priceYearly": "50.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
},
{"id": "5e0ba6ac14e2590f760a0f0f",
"title": "LTT Supporter Plus",
"description": "You are the real MVP. \n\nYour support helps us continue to build out our team, drive up production values, run experiments that might lose money for a long time (*cough* LTX *cough*) and otherwise be the best content creators we can be.\n\nThis tier includes all the perks of the previous ones, but at floatplane's glorious high bitrate 4K!",
"price": "10.00",
"priceYearly": "100.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": false,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
}
],
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false,
"card": {"width": 375,
"height": 500,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871.jpeg",
"childImages": [{"width": 300,
"height": 400,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871_300x400.jpeg"
}
]
}
},
"wasReleasedSilently": true,
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"isAccessible": true,
"videoAttachments": ["TViGzkuIic"
],
"audioAttachments": [ ],
"pictureAttachments": [ ],
"galleryAttachments": [ ]
},
{"id": "ge4gLGfXnz",
"guid": "ge4gLGfXnz",
"title": "Livestream VOD – October 8, 2021 @ 20:26 – I Have MORE to Say About Steam Deck - WAN Show October 8, 2021",
"text": "<p>Honey automatically applies the best coupon codes to save you money at </p><p>different online checkouts, try it now at <a href=\"https://www.joinhoney.com/linus\">https://www.joinhoney.com/linus</a></p><p><br /></p><p>Buy a Seasonic Ultra Titanium PSU</p><p>On Amazon: <a href=\"https://geni.us/q4lnefC\">https://geni.us/q4lnefC</a></p><p>On NewEgg: <a href=\"https://lmg.gg/8KV3S\">https://lmg.gg/8KV3S</a></p><p><br /></p><p>Visit <a href=\"https://www.squarespace.com/WAN\">https://www.squarespace.com/WAN</a> and use offer code WAN for 10% off</p><p><br /></p><p>Podcast Download: TBD</p><p><br /></p><p>Check out our other Podcasts:</p><p>Carpool Critics Movie Podcast: <a href=\"https://www.youtube.com/channel/UCt-oJR5teQIjOAxCmIQvcgA\">https://www.youtube.com/channel/UCt-oJR5teQIjOAxCmIQvcgA</a></p><p><br /></p><p>Timestamps TBD</p>",
"type": "blogPost",
"attachmentOrder": ["psqoN3CgMH",
"KijsTQP8Rr"
],
"metadata": {"hasVideo": true,
"videoCount": 2,
"videoDuration": 9506,
"hasAudio": false,
"audioCount": 0,
"audioDuration": 0,
"hasPicture": false,
"pictureCount": 0,
"hasGallery": false,
"galleryCount": 0,
"isFeatured": false
},
"releaseDate": "2021-10-09T09:28:00.015Z",
"likes": 43,
"dislikes": 3,
"score": 40,
"comments": 24,
"creator": {"id": "59f94c0bdd241b70349eb72b",
"owner": {"id": "59f94c0bdd241b70349eb723",
"username": "Linus"
},
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": {"title": "Technology"
},
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "First Linux Stream",
"description": "<p>chat on Twitch</p>",
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": [{"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"description": "Includes:\n- Early access (when possible)\n- Live Streaming\n- Behind-the-scenes, cutting room floor & exclusives\n\nNOTE: Tech Quickie and TechLinked are included for now, but will move to their own Floatplane pages in the future",
"price": "5.00",
"priceYearly": "50.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
},
{"id": "5e0ba6ac14e2590f760a0f0f",
"title": "LTT Supporter Plus",
"description": "You are the real MVP. \n\nYour support helps us continue to build out our team, drive up production values, run experiments that might lose money for a long time (*cough* LTX *cough*) and otherwise be the best content creators we can be.\n\nThis tier includes all the perks of the previous ones, but at floatplane's glorious high bitrate 4K!",
"price": "10.00",
"priceYearly": "100.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": false,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
}
],
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false,
"card": {"width": 375,
"height": 500,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871.jpeg",
"childImages": [{"width": 300,
"height": 400,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871_300x400.jpeg"
}
]
}
},
"wasReleasedSilently": false,
"thumbnail": {"width": 640,
"height": 360,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/ge4gLGfXnz/564833356017787_1633771544979.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/ge4gLGfXnz/564833356017787_1633771544979_400x225.jpeg"
}
]
},
"isAccessible": true,
"videoAttachments": ["KijsTQP8Rr",
"psqoN3CgMH"
],
"audioAttachments": [ ],
"pictureAttachments": [ ],
"galleryAttachments": [ ]
}
],
"lastElements": [{"creatorId": "59f94c0bdd241b70349eb72b",
"blogPostId": "l2wH2gXLiW",
"moreFetchable": true
}
]
}

Get Content Tags

Retrieve all tags and the number of times the tags have been used for the specified creator(s).

Authorizations:

CookieAuth

query Parameters

creatorIds

required

Array of strings[ items non-empty ]

The creator(s) to search by.

Responses

Response samples

Content type

application/json

{"battery": 1,
"server": 1,
"Airpods": 1,
"storage": 1,
"tjm": 1,
"Apple": 1,
"swap": 1,
"memory": 1,
"ltt": 1
}

Get Blog Post

Retrieve more details on a specific blog post object for viewing.

Authorizations:

CookieAuth

query Parameters

id

required

string

The ID of the post to be retrieved.

Responses

Response samples

Content type

application/json

{"id": "Dw2ms0AgL8",
"guid": "Dw2ms0AgL8",
"title": "Livestream VOD – October 9, 2021 @ 07:18 – First Linux Stream",
"text": "<p>chat on Twitch</p>",
"type": "blogPost",
"tags": ["test"
],
"attachmentOrder": ["TViGzkuIic"
],
"metadata": {"hasVideo": true,
"videoCount": 1,
"videoDuration": 5689,
"hasAudio": false,
"audioCount": 0,
"audioDuration": 0,
"hasPicture": false,
"pictureCount": 0,
"hasGallery": false,
"galleryCount": 0,
"isFeatured": false
},
"releaseDate": "2021-10-09T09:29:00.039Z",
"likes": 41,
"dislikes": 0,
"score": 41,
"comments": 28,
"creator": {"id": "59f94c0bdd241b70349eb72b",
"owner": "59f94c0bdd241b70349eb723",
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": "59f94c0bdd241b70349eb727",
"cover": null,
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": null,
"subscriptionPlans": null,
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false
},
"wasReleasedSilently": true,
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"isAccessible": true,
"userInteraction": [ ],
"videoAttachments": [{"id": "TViGzkuIic",
"guid": "TViGzkuIic",
"title": "October 9, 2021 @ 07:18 – First Linux Stream",
"type": "video",
"description": "",
"releaseDate": null,
"duration": 5689,
"creator": "59f94c0bdd241b70349eb72b",
"likes": 0,
"dislikes": 0,
"score": 0,
"isProcessing": false,
"primaryBlogPost": "Dw2ms0AgL8",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/content_thumbnails/TViGzkuIic/324783659287024_1633769709593.jpeg",
"childImages": [ ]
},
"isAccessible": true
}
],
"audioAttachments": [{"id": "iGssjNGPSD",
"guid": "iGssjNGPSD",
"title": "Robocop FP.mp3",
"type": "audio",
"description": "",
"duration": 4165,
"waveform": {"dataSetLength": 3,
"highestValue": 71,
"lowestValue": 50,
"data": [71,
50,
69
]
},
"creator": "59f94c0bdd241b70349eb72b",
"likes": 0,
"dislikes": 0,
"score": 0,
"isProcessing": false,
"primaryBlogPost": "jVU2y9PlnG",
"isAccessible": true
}
],
"pictureAttachments": [ ],
"galleryAttachments": [ ]
}

Get Related Blog Posts

Retrieve a list of blog posts that are related to the post being viewed.

Authorizations:

CookieAuth

query Parameters

id

required

string

The ID of the originating post.

Responses

Response samples

Content type

application/json

[{"id": "ge4gLGfXnz",
"guid": "ge4gLGfXnz",
"title": "Livestream VOD – October 8, 2021 @ 20:26 – I Have MORE to Say About Steam Deck - WAN Show October 8, 2021",
"text": "<p>Honey automatically applies the best coupon codes to save you money at </p><p>different online checkouts, try it now at <a href=\"https://www.joinhoney.com/linus\">https://www.joinhoney.com/linus</a></p><p><br /></p><p>Buy a Seasonic Ultra Titanium PSU</p><p>On Amazon: <a href=\"https://geni.us/q4lnefC\">https://geni.us/q4lnefC</a></p><p>On NewEgg: <a href=\"https://lmg.gg/8KV3S\">https://lmg.gg/8KV3S</a></p><p><br /></p><p>Visit <a href=\"https://www.squarespace.com/WAN\">https://www.squarespace.com/WAN</a> and use offer code WAN for 10% off</p><p><br /></p><p>Podcast Download: TBD</p><p><br /></p><p>Check out our other Podcasts:</p><p>Carpool Critics Movie Podcast: <a href=\"https://www.youtube.com/channel/UCt-oJR5teQIjOAxCmIQvcgA\">https://www.youtube.com/channel/UCt-oJR5teQIjOAxCmIQvcgA</a></p><p><br /></p><p>Timestamps TBD</p>",
"type": "blogPost",
"tags": ["test"
],
"attachmentOrder": ["psqoN3CgMH",
"KijsTQP8Rr"
],
"metadata": {"hasVideo": true,
"videoCount": 2,
"videoDuration": 9506,
"hasAudio": false,
"audioCount": 0,
"audioDuration": 0,
"hasPicture": false,
"pictureCount": 0,
"hasGallery": false,
"galleryCount": 0,
"isFeatured": false
},
"releaseDate": "2021-10-09T09:28:00.015Z",
"likes": 43,
"dislikes": 3,
"score": 40,
"comments": 24,
"creator": {"id": "59f94c0bdd241b70349eb72b",
"owner": {"id": "59f94c0bdd241b70349eb723",
"username": "Linus"
},
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": {"title": "Technology"
},
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "First Linux Stream",
"description": "<p>chat on Twitch</p>",
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": [{"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"description": "Includes:\n- Early access (when possible)\n- Live Streaming\n- Behind-the-scenes, cutting room floor & exclusives\n\nNOTE: Tech Quickie and TechLinked are included for now, but will move to their own Floatplane pages in the future",
"price": "5.00",
"priceYearly": "50.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
},
{"id": "5e0ba6ac14e2590f760a0f0f",
"title": "LTT Supporter Plus",
"description": "You are the real MVP. \n\nYour support helps us continue to build out our team, drive up production values, run experiments that might lose money for a long time (*cough* LTX *cough*) and otherwise be the best content creators we can be.\n\nThis tier includes all the perks of the previous ones, but at floatplane's glorious high bitrate 4K!",
"price": "10.00",
"priceYearly": "100.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": false,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
}
],
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false,
"card": {"width": 375,
"height": 500,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871.jpeg",
"childImages": [{"width": 300,
"height": 400,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871_300x400.jpeg"
}
]
}
},
"wasReleasedSilently": false,
"thumbnail": {"width": 640,
"height": 360,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/ge4gLGfXnz/564833356017787_1633771544979.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/ge4gLGfXnz/564833356017787_1633771544979_400x225.jpeg"
}
]
},
"isAccessible": true
},
{"id": "j7KjCaKrtV",
"guid": "j7KjCaKrtV",
"title": "TL: Facebook Does Not Care.",
"text": "<p><strong>NEWS SOURCES:</strong></p><p><strong> </strong></p><p>MICRO-BOSS, WORD</p><p>Microsoft to make its devices more repairable following pressure</p><p><a href=\"https://linustechtips.com/topic/1379452-microsoft-agrees-to-independent-third-party-study-to-look-into-right-to-repair/\">https://linustechtips.com/topic/1379452-microsoft-agrees-to-independent-third-party-study-to-look-into-right-to-repair/</a></p><p><a href=\"https://grist.org/accountability/bowing-to-investors-microsoft-will-make-its-devices-easier-to-fix/\">https://grist.org/accountability/bowing-to-investors-microsoft-will-make-its-devices-easier-to-fix/</a></p><p><a href=\"https://www.asyousow.org/about-us#:~:text=As%20You%20Sow%20is%20the%20nation%E2%80%99s%20non-profit%20leader%20in%20shareholder%20advocacy\">https://www.asyousow.org/about-us#:~:text=As%20You%20Sow%20is%20the%20nation%E2%80%99s%20non-profit%20leader%20in%20shareholder%20advocacy</a>.</p><p>Louis is happy <a href=\"https://www.youtube.com/watch?v=TiMdvR99fBQ\">https://www.youtube.com/watch?v=TiMdvR99fBQ</a></p><p> </p><p>WHAT, THIS OLE’D THING?</p><p>Switch OLED launches <a href=\"https://arstechnica.com/gaming/2021/10/switch-oled-review-nintendos-nicest-most-nonessential-upgrade-yet/\">https://arstechnica.com/gaming/2021/10/switch-oled-review-nintendos-nicest-most-nonessential-upgrade-yet/</a></p><p><a href=\"https://www.youtube.com/watch?v=4mHq6Y7JSmg\">https://www.youtube.com/watch?v=4mHq6Y7JSmg</a></p><p>New Joy-Cons, but drift isn’t going away</p><p><a href=\"https://www.polygon.com/22688586/nintendo-switch-oled-joy-con-drift-controllers\">https://www.polygon.com/22688586/nintendo-switch-oled-joy-con-drift-controllers</a></p><p>screen protector <a href=\"https://www.nintendolife.com/news/2021/10/switch-oled-comes-with-a-screen-protector-installed-but-please-dont-remove-it-says-nintendo\">https://www.nintendolife.com/news/2021/10/switch-oled-comes-with-a-screen-protector-installed-but-please-dont-remove-it-says-nintendo</a></p><p> </p><p>SHAMEBOOK</p><p>Facebook has more outages</p><p><a href=\"https://www.engadget.com/facebook-and-instagram-are-down-for-the-second-time-this-week-193257623.html\">https://www.engadget.com/facebook-and-instagram-are-down-for-the-second-time-this-week-193257623.html</a></p><p><a href=\"https://twitter.com/Facebook/status/1446556732977778695\">https://twitter.com/Facebook/status/1446556732977778695</a></p><p>IG fixed <a href=\"https://twitter.com/InstagramComms/status/1446582114468597761\">https://twitter.com/InstagramComms/status/1446582114468597761</a></p><p>Unfollow everything developer banned <a href=\"https://www.theverge.com/2021/10/8/22716044/facebook-unfollow-everything-tool-louis-barclay-banned-for-life\">https://www.theverge.com/2021/10/8/22716044/facebook-unfollow-everything-tool-louis-barclay-banned-for-life</a></p><p><a href=\"https://slate.com/technology/2021/10/facebook-unfollow-everything-cease-desist.html\">https://slate.com/technology/2021/10/facebook-unfollow-everything-cease-desist.html</a></p><p><a href=\"https://louisbarclay.notion.site/Unfollow-Everything-cease-and-desist-letter-from-Facebook-ea219169421b457bb7ce010b7bf9ce1f\">https://louisbarclay.notion.site/Unfollow-Everything-cease-and-desist-letter-from-Facebook-ea219169421b457bb7ce010b7bf9ce1f</a></p><p> </p><p>QUICK BITS</p><p> </p><p>GET JEFF’D</p><p>Game backgrounds on Twitch replaced with Jeff Bezos</p><p><a href=\"https://twitter.com/AnEternalEnigma/status/1446421951883489281\">https://twitter.com/AnEternalEnigma/status/1446421951883489281</a></p><p>defaced <a href=\"https://www.cnet.com/tech/gaming/twitch-reportedly-defaced-with-pictures-of-jeff-bezos/\">https://www.cnet.com/tech/gaming/twitch-reportedly-defaced-with-pictures-of-jeff-bezos/</a></p><p> </p><p>ABOUT TO GET PADDLED</p><p>First In-App Purchasing alternative for iOS: Paddle</p><p><a href=\"https://twitter.com/PaddleHQ/status/1446050078301605890\">https://twitter.com/PaddleHQ/status/1446050078301605890</a></p><p><a href=\"https://paddle.com/platform/in-app-purchase/\">https://paddle.com/platform/in-app-purchase/</a></p><p>Sweeney</p><p><a href=\"https://twitter.com/TimSweeneyEpic/status/1446117510919585796\">https://twitter.com/TimSweeneyEpic/status/1446117510919585796</a></p><p> </p><p>STAY KINECTED</p><p>Sky Glass TV looks like a big iMac</p><p><a href=\"https://www.youtube.com/watch?v=GpGskL5PCKU\">https://www.youtube.com/watch?v=GpGskL5PCKU</a></p><p>Kinect motion controls <a href=\"https://www.theverge.com/2021/10/7/22714117/microsoft-kinect-is-back-sky-glass-tv-smart-camera-features\">https://www.theverge.com/2021/10/7/22714117/microsoft-kinect-is-back-sky-glass-tv-smart-camera-features</a> - full screen embedded video on this page and record</p><p><br /></p><p>UPGRADED TO CUMULONIMBUS</p><p>XCloud is now running Xbox Series X hardware</p><p><a href=\"https://www.kitguru.net/gaming/matthew-wilson/microsoft-has-upgraded-xcloud-to-xbox-series-x-hardware/\">https://www.kitguru.net/gaming/matthew-wilson/microsoft-has-upgraded-xcloud-to-xbox-series-x-hardware/</a></p><p><a href=\"https://www.eurogamer.net/articles/2021-10-07-xbox-cloud-gaming-now-runs-on-series-x-hardware\">https://www.eurogamer.net/articles/2021-10-07-xbox-cloud-gaming-now-runs-on-series-x-hardware</a></p><p> </p><p>NO PIXEL LEFT UN-LEAKED</p><p>Pixel 6 and 6 Pro teardowns leaked</p><p><a href=\"https://9to5google.com/2021/10/08/pixel-6-pro-teardown-leak/\">https://9to5google.com/2021/10/08/pixel-6-pro-teardown-leak/</a></p>",
"type": "blogPost",
"attachmentOrder": ["R3mVASdVGt"
],
"metadata": {"hasVideo": true,
"videoCount": 1,
"videoDuration": 377,
"hasAudio": false,
"audioCount": 0,
"audioDuration": 0,
"hasPicture": false,
"pictureCount": 0,
"hasGallery": false,
"galleryCount": 0,
"isFeatured": false
},
"releaseDate": "2021-10-09T02:55:00.045Z",
"likes": 101,
"dislikes": 0,
"score": 101,
"comments": 19,
"creator": {"id": "59f94c0bdd241b70349eb72b",
"owner": {"id": "59f94c0bdd241b70349eb723",
"username": "Linus"
},
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": {"title": "Technology"
},
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "First Linux Stream",
"description": "<p>chat on Twitch</p>",
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": [{"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"description": "Includes:\n- Early access (when possible)\n- Live Streaming\n- Behind-the-scenes, cutting room floor & exclusives\n\nNOTE: Tech Quickie and TechLinked are included for now, but will move to their own Floatplane pages in the future",
"price": "5.00",
"priceYearly": "50.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
},
{"id": "5e0ba6ac14e2590f760a0f0f",
"title": "LTT Supporter Plus",
"description": "You are the real MVP. \n\nYour support helps us continue to build out our team, drive up production values, run experiments that might lose money for a long time (*cough* LTX *cough*) and otherwise be the best content creators we can be.\n\nThis tier includes all the perks of the previous ones, but at floatplane's glorious high bitrate 4K!",
"price": "10.00",
"priceYearly": "100.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": false,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
}
],
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false,
"card": {"width": 375,
"height": 500,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871.jpeg",
"childImages": [{"width": 300,
"height": 400,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871_300x400.jpeg"
}
]
}
},
"wasReleasedSilently": false,
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/j7KjCaKrtV/726584368653303_1633741254596.jpeg",
"childImages": [{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/j7KjCaKrtV/726584368653303_1633741254596_1200x675.jpeg"
},
{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/j7KjCaKrtV/726584368653303_1633741254596_400x225.jpeg"
}
]
},
"isAccessible": true
},
{"id": "VkxlNv3k8j",
"guid": "VkxlNv3k8j",
"title": "TQ: Has USB-C WON Against Apple?",
"text": "<p>Learn about the proposed USB-C mandate in the EU.</p>",
"type": "blogPost",
"attachmentOrder": ["7OWQQsxYYN"
],
"metadata": {"hasVideo": true,
"videoCount": 1,
"videoDuration": 293,
"hasAudio": false,
"audioCount": 0,
"audioDuration": 0,
"hasPicture": false,
"pictureCount": 0,
"hasGallery": false,
"galleryCount": 0,
"isFeatured": false
},
"releaseDate": "2021-10-08T23:31:00.037Z",
"likes": 106,
"dislikes": 0,
"score": 106,
"comments": 15,
"creator": {"id": "59f94c0bdd241b70349eb72b",
"owner": {"id": "59f94c0bdd241b70349eb723",
"username": "Linus"
},
"title": "LinusTechTips",
"urlname": "linustechtips",
"description": "We make entertaining videos about technology, including tech reviews, showcases and other content.",
"about": "# We're LinusTechTips\nWe make videos and stuff, cool eh?",
"category": {"title": "Technology"
},
"cover": {"width": 1990,
"height": 519,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867.jpeg",
"childImages": [{"width": 1245,
"height": 325,
"path": "https://pbs.floatplane.com/cover_images/59f94c0bdd241b70349eb72b/696951209272749_1521668313867_1245x325.jpeg"
}
]
},
"icon": {"width": 600,
"height": 600,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205.jpeg",
"childImages": [{"width": 250,
"height": 250,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_250x250.jpeg"
},
{"width": 100,
"height": 100,
"path": "https://pbs.floatplane.com/creator_icons/59f94c0bdd241b70349eb72b/770551996990709_1551249357205_100x100.jpeg"
}
]
},
"liveStream": {"id": "5c13f3c006f1be15e08e05c0",
"title": "First Linux Stream",
"description": "<p>chat on Twitch</p>",
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/084281881402899_1633761128412_400x225.jpeg"
}
]
},
"owner": "59f94c0bdd241b70349eb72b",
"streamPath": "/api/video/v1/us-east-1.758417551536.channel.yKkxur4ukc0B.m3u8",
"offline": {"title": "Offline",
"description": "We're offline for now – please check back later!",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/stream_thumbnails/5c13f3c006f1be15e08e05c0/894654974252956_1549059179026_1200x675.jpeg"
}
]
}
}
},
"subscriptionPlans": [{"id": "5d48d0306825b5780db93d07",
"title": "LTT Supporter (1080p)",
"description": "Includes:\n- Early access (when possible)\n- Live Streaming\n- Behind-the-scenes, cutting room floor & exclusives\n\nNOTE: Tech Quickie and TechLinked are included for now, but will move to their own Floatplane pages in the future",
"price": "5.00",
"priceYearly": "50.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": true,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
},
{"id": "5e0ba6ac14e2590f760a0f0f",
"title": "LTT Supporter Plus",
"description": "You are the real MVP. \n\nYour support helps us continue to build out our team, drive up production values, run experiments that might lose money for a long time (*cough* LTX *cough*) and otherwise be the best content creators we can be.\n\nThis tier includes all the perks of the previous ones, but at floatplane's glorious high bitrate 4K!",
"price": "10.00",
"priceYearly": "100.00",
"currency": "usd",
"logo": null,
"interval": "month",
"featured": false,
"allowGrandfatheredAccess": false,
"discordServers": [ ],
"discordRoles": [ ]
}
],
"discoverable": true,
"subscriberCountDisplay": "total",
"incomeDisplay": false,
"card": {"width": 375,
"height": 500,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871.jpeg",
"childImages": [{"width": 300,
"height": 400,
"path": "https://pbs.floatplane.com/creator_card/59f94c0bdd241b70349eb72b/281467946609369_1551250329871_300x400.jpeg"
}
]
}
},
"wasReleasedSilently": false,
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/VkxlNv3k8j/438666910492097_1633734872237.jpeg",
"childImages": [{"width": 400,
"height": 225,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/VkxlNv3k8j/438666910492097_1633734872237_400x225.jpeg"
},
{"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/blogPost_thumbnails/VkxlNv3k8j/438666910492097_1633734872237_1200x675.jpeg"
}
]
},
"isAccessible": true
}
]

Get Video Content

Retrieve more information on a video attachment from a blog post in order to consume the video content.

Authorizations:

CookieAuth

query Parameters

id

required

string

The ID of the video attachment object, from the BlogPostModelV3.

Responses

Response samples

Content type

application/json

{"id": "TViGzkuIic",
"guid": "TViGzkuIic",
"title": "October 9, 2021 @ 07:18 – First Linux Stream",
"type": "video",
"description": "",
"releaseDate": null,
"duration": 5689,
"creator": "59f94c0bdd241b70349eb72b",
"likes": 0,
"dislikes": 0,
"score": 0,
"isProcessing": false,
"primaryBlogPost": "Dw2ms0AgL8",
"thumbnail": {"width": 1920,
"height": 1080,
"path": "https://pbs.floatplane.com/content_thumbnails/TViGzkuIic/324783659287024_1633769709593.jpeg",
"childImages": [ ]
},
"isAccessible": true,
"blogPosts": ["Dw2ms0AgL8"
],
"timelineSprite": {"width": 4960,
"height": 2610,
"path": "https://pbs.floatplane.com/timeline_sprite/TViGzkuIic/142493855372807_1633769996492.jpeg",
"childImages": [ ]
},
"userInteraction": [ ],
"levels": [{"name": "360",
"width": 640,
"height": 360,
"label": "360p",
"order": 0
},
{"name": "480",
"width": 854,
"height": 480,
"label": "480p",
"order": 1
},
{"name": "720",
"width": 1280,
"height": 720,
"label": "720p",
"order": 2
}
]
}

Get Audio Content

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Get Picture Content

Retrieve more information on a picture attachment from a blog post in order to consume the picture content.

Authorizations:

CookieAuth

query Parameters

id

required

string

The ID of the picture attachment object, from the BlogPostModelV3.

Responses

Response samples

Content type

application/json

{"id": "ZWKdCy8TMN",
"guid": "ZWKdCy8TMN",
"title": "\"I hate costumes\" Jonathan",
"type": "picture",
"description": "",
"likes": 1,
"dislikes": 0,
"score": 1,
"isProcessing": false,
"creator": "59f94c0bdd241b70349eb72b",
"primaryBlogPost": "PGZBzzRWpD",
"userInteraction": [ ],
"thumbnail": {"width": 1200,
"height": 675,
"path": "https://pbs.floatplane.com/picture_thumbnails/ZWKdCy8TMN/239212458322156_1634845035660.jpeg",
"childImages": [ ]
},
"isAccessible": true,
"imageFiles": [{"path": "https://pbs.floatplane.com/content_images/59f94c0bdd241b70349eb72b/465975275316873_1634845031494_1164x675.jpeg?AWSAccessKeyId=...&Expires=...&Signature=...",
"width": 1164,
"height": 675,
"size": 165390
}
]
}

Get Content Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Like Content

Toggles the like status on a piece of content. If disliked before, it will turn into a like. If liked before, the like will be removed.

Authorizations:

CookieAuth

Request Body schema: application/json

contentType required	string Value: "blogPost"
id required	string

Responses

Request samples

Payload

Content type

application/json

{"contentType": "blogPost",
"id": "T2gWkpaerq"
}

Response samples

Content type

application/json

["like"
]

Dislike Content

Toggles the dislike status on a piece of content. If liked before, it will turn into a dislike. If disliked before, the dislike will be removed.

Authorizations:

CookieAuth

Request Body schema: application/json

contentType required	string Value: "blogPost"
id required	string

Responses

Request samples

Payload

Content type

application/json

{"contentType": "blogPost",
"id": "T2gWkpaerq"
}

Response samples

Content type

application/json

["dislike"
]

Get Picture Url Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Update Progress

Update the watch progress on a piece of media (usually video or audio), stored as the number of seconds in the media.

Authorizations:

CookieAuth

Request Body schema: application/json

id required	string The video or audio attachment identifier for the piece of media that is being updated. Note: this is not the blogPost identifier.
contentType required	string Enum: "video" "audio" Which type of media the corresponding identifier is.
progress required	integer >= 0 The progress through the media that has been consumed by the user, in seconds.

Responses

Request samples

Payload

Content type

application/json

{"ids": ["mhhrOfndeF",
"3qZrz5ugsa"
],
"contentType": "blogPost"
}

Response samples

Content type

text/plain

OK

Get Progress

Batch retrieval of watch progress values for blog posts. This API is useful for showing progress of a list of blog posts shown on the screen to the user. When retrieving a list of blog posts, the media attachments only include the identifier; when retrieving full details of a blog post, the attachments include more information, but still fail to return the progress of the media. Only when pulling the full video/audio content does the progress get included in the response. Thus, the recommended approach is to pull paginated results of blog posts first, as usual, and then to call this endpoint to retrieve progress values for each blog post to show in some capacity, usually on the thumbnail as a progress bar on the bottom.

Note that the progress values returned in this endpoint are different from the update progress endpoint and the values returned in video/audio attachments. While the latter are measured in seconds, this endpoint returns progress as a percentage of the media's total duration. It is presumed that the progress returned is from the first attachment in the blog post's attachmentOrder that is either a video or audio attachment. Because this returns progress as an integer percentage (0 to 100), it is not recommended to use this particular value for jumping to a timestamp in the media when resuming playback, as the rounded number may be off by plus/minus several seconds in actual playback. Use the actual attachment progress, measured in seconds, instead.

Authorizations:

CookieAuth

Request Body schema: application/json

ids required	Array of strings The identifiers of the blog posts from which progress should be retrieved.
contentType required	string Value: "blogPost" The type of the corresponding identifiers. The only value currently is `blogPost`.

Responses

Request samples

Payload

Content type

application/json

{"ids": ["mhhrOfndeF",
"3qZrz5ugsa"
],
"contentType": "blogPost"
}

Response samples

Content type

application/json

[{"id": "3qZrz5ugsa",
"progress": 0
},
{"id": "mhhrOfndeF",
"progress": 100
}
]

application/json

{ }

thumbnailUpdateUnsubscribeV3

Thumnail management.

Thumbnail Update Unsubscribe Deprecated

TODO - Not used in Floatplane code.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

{ }

Vote Poll

Vote on an option of a poll. Voting a second time or attempting to change a choice may result in an error.

Authorizations:

CookieAuth

Request Body schema: application/json

pollId required	string The id of the poll to vote on.
optionIndex required	integer The index of the options of the poll for which to vote. This should not be outside the bounds of the poll options.

Responses

Request samples

Payload

Content type

application/json

{"pollId": "62c8c1dd968bc0899bbb4b92",
"optionIndex": 1
}

Response samples

Content type

application/json

{ }

CMS List Polls

TODO

Authorizations:

CookieAuth

Request Body schema: application/json

creatorId required	string
skip required	integer
limit required	integer
activeOnly required	boolean

Responses

Request samples

Payload

Content type

application/json

{"creatorId": "59f94c0bdd241b70349eb72b",
"skip": 0,
"limit": 20,
"activeOnly": false
}

Response samples

Content type

application/json

{ }

Create Live Poll

TODO

Authorizations:

CookieAuth

Request Body schema: application/json

creatorId required	string
type required	string
title required	string
options required	Array of strings >= 2 items
duration required	string

Responses

Request samples

Payload

Content type

application/json

{"creatorId": "string",
"type": "string",
"title": "string",
"options": ["string",
"string"
],
"duration": "string"
}

Response samples

Content type

application/json

{ }

Close Poll

TODO

Authorizations:

CookieAuth

Request Body schema: application/json

pollId

required

string

Responses

Request samples

Payload

Content type

application/json

{"pollId": "string"
}

Response samples

Content type

application/json

{ }

RedirectV3

Channel-level redirection to Youtube or other sites for latest videos outside of Floatplane.

Redirect to YouTube Latest Video

Redirects (HTTP 302) the user to the latest LMG video for a given LMG channel key. For example, visiting this URL with a channelKey of sc, it will take you directly to the latest Short Circuit video on YouTube. Unknown if this works for non-LMG creators for their channels. Not used in Floatplane code.

Authorizations:

CookieAuth

path Parameters

channelKey

required

string

Known possible values: ltt, tq, sc, tl, csf, tjm, lmgc, ma

Responses

Response samples

400
401
403
404
default

Content type

application/json

{"id": "awoz-3s5g-6amf",
"errors": [{"id": "9edc-zejt-n3hb",
"name": "paramValidationError",
"message": "\"captchaToken\" must be an object",
"data": {"rule": "object.base"
}
}
],
"message": "\"captchaToken\" must be an object"
}

LoyaltyRewardsV3

Loyalty rewards information and claiming.

List Creator Loyalty Reward

Retrieve a list of loyalty rewards for the user. The reason for why this is a POST and not a GET is unknown.

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

[ ]

Claim Loyalty Reward

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

Content type

application/json

{ }

CreatorAdministration

Add Creator Moderator By Path

TODO

Authorizations:

CookieAuth

path Parameters

creator

required

string

Responses

Response samples

Content type

application/json

{ }

Remove Creator Moderator

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

Remove Creator Moderator By Path

TODO

Authorizations:

CookieAuth

path Parameters

creator

required

string

Responses

Response samples

Content type

application/json

{ }

List Moderators

TODO

Authorizations:

CookieAuth

Responses

Response samples

Content type

application/json

{ }

List Moderators By Path

TODO

Authorizations:

CookieAuth

path Parameters

creator

required

string

Responses

Response samples

Content type

application/json

{ }