JellyJelly API
API Reference
The JellyJelly API lets you search public jellies, fetch a video by id, and list the payments that video received. Base URL: https://api.jellyjelly.com
Search, retrieve, and public payment endpoints work 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.
Payments received
/v3/jelly/{jelly_id}/transactions
Look up a video with GET /v3/jelly/{jelly_id}, then list the payments
that video received. Each row is a public transfer: token, amount, sender, note, and chain hash.
Returns application/json.
Path parameters
| Parameter | Type | Description |
|---|---|---|
jelly_id | string | The jelly whose received payments you want. The explorer also accepts a /watch/… URL. |
Query parameters
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number. Default 1. |
page_size | integer | Items per page. Default 15. |
Transaction fields
| Field | Description |
|---|---|
amount, token | How much was paid, and in which token (for example jellyjelly). |
type | Payment kind, such as transfer. |
sender | Who paid: username, full_name, and profile photo. |
note_text | Optional note attached to the payment. |
transaction_hash | On-chain signature for the transfer. |
created_at | When the payment was recorded. ISO 8601. |
API explorer
Send a live request through the site proxy. Responses come from https://api.jellyjelly.com.