JellyJelly API
API Reference
The JellyJelly API lets you search public jellies and fetch video metadata. Base URL: https://api.jellyjelly.com
Search and get endpoints return public content without a token. Authenticated requests can unlock paid or private fields when your user has access.
https://api.jellyjelly.comAuthentication
Most read endpoints work unauthenticated. For elevated access, create a token in Developer → API Tokens and send:
Authorization: Token <your_api_token> Bearer session tokens from the JellyJelly web app also work for the explorer below when “Use auth” is enabled.
Search jellies
/v3/jelly/search
Search public jellies by title, summary, and username. Results only include public content.
Returns application/json.
Query parameters
| Parameter | Type | Description |
|---|---|---|
q | string | Search query for title/summary. Supports phrase and word matching. |
username | string | Filter by creator username (case-insensitive partial match). |
start_date | string | Posted on or after this time. ISO 8601. |
end_date | string | Posted on or before this time. ISO 8601. |
sort_by | string | date, likes, or views. With q, defaults to relevance. |
ascending | boolean | true or false. Default false. |
page | integer | Page number. Default 1. |
page_size | integer | Items per page. Default 10. Max 50. |
Retrieve a jelly
/v3/jelly/{jelly_id}
Fetch a single jelly by ID. Unauthenticated callers receive full public fields, or a limited hint payload for paid content.
Path parameters
| Parameter | Type | Description |
|---|---|---|
jelly_id | string | The jelly identifier (also accepted from a /watch/… URL in the explorer). |
List query parameters
When listing a user’s jellies instead of fetching by ID:
| Parameter | Type | Description |
|---|---|---|
user_id | string | User ID to list jellies for. |
page | integer | Page number. Default 1. |
page_size | integer | Items per page. Default 15. Max 50. |
Access levels
| Attribute | Manage | View | Hint |
|---|---|---|---|
| access, id, participants, title, privacy | Yes | Yes | Yes |
| video (hls_master, mp4_fallback) | Yes | Yes | No |
| likes_count, comments_count, all_views | Yes | Yes | No |
| price, pay_to_watch | Yes | Yes* | Yes* |
* Present when the jelly is monetized.
API explorer
Send a live request through the site proxy. Responses come from https://api.jellyjelly.com.