Invite & Download
Invite code: A01B
Search Jellies /v3/jelly/search
Method: GET
Returns: application/json
Searches public jellies by title, summary, and username. Only returns jellies that are public.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
q | string | Search query for title/summary. Supports exact phrase and word matching. |
username | string | Filter by creator/participant username (case-insensitive partial match). |
start_date | string | Filter jellies posted on or after this date. ISO 8601 format. |
end_date | string | Filter jellies posted on or before this date. ISO 8601 format. |
sort_by | string | date, likes, or views. With query, defaults to relevance. |
ascending | string | true or false. Default false. |
page | int | Page number. Default 1. |
page_size | int | Items per page. Default 10. Max 50. |
Sample Response
{
"status": "success",
"total": 17,
"page": 1,
"page_size": 10,
"query": "iqram",
"username": "",
"sort_by": "date",
"ascending": false,
"start_date": "",
"end_date": "",
"jellies": [
{
"id": "01KHPGFG41A64J3YXNQYQK4K57",
"started_by_id": "37bb986e-833f-4498-a236-88cdc6988ad5",
"participants": [
{
"id": "37bb986e-833f-4498-a236-88cdc6988ad5",
"username": "marmo",
"full_name": "mark mollé",
"pfp_url": "https://user-pfp.jellyjelly.com/.../image-min.jpeg"
}
],
"title": "Planning Iqram's Participation in Upcoming Crypto Event",
"thumbnail_url": "https://dist.jellyjelly.com/.../thumbnail.jpeg?...",
"posted_at": "2026-02-17T19:15:50.599Z"
},
{
"id": "01KHJ3GQH3V5XBCRSA4JPG04JR",
"started_by_id": "4fb1da2c-ad21-457f-8553-87e88d44aa2f",
"participants": [
{
"id": "4fb1da2c-ad21-457f-8553-87e88d44aa2f",
"username": "amirsultanmalik",
"full_name": "Amir Awan",
"pfp_url": null
}
],
"title": "Celebrating Iqram and Excitement for Crypto Mondays at Pops Bar",
"thumbnail_url": "https://dist.jellyjelly.com/.../thumbnail.jpeg?...",
"posted_at": "2026-02-16T02:12:21.696Z"
},
{
"id": "01KH4JQBE4K1N0M2H6ZVV54P56",
"started_by_id": "25304266-539f-49b8-ba4b-993298fd9b03",
"participants": [
{
"id": "25304266-539f-49b8-ba4b-993298fd9b03",
"username": "iqram",
"full_name": "Iqram Magdon-Ismail",
"pfp_url": "https://user-pfp.jellyjelly.com/.../xtsmba-min.jpeg"
}
],
"title": "Iqram's Secret Artist Lineup at Solana Skyline This March",
"thumbnail_url": "https://dist.jellyjelly.com/.../thumbnail.jpeg?...",
"posted_at": "2026-02-10T20:08:45.325Z"
}
]
}Get Jelly /v3/jelly/{jelly_id}
Method: GET
Returns: application/json
URL Parameters
jelly_id — The ID of the jelly to retrieve.
Query Parameters (for listing)
| Parameter | Type | Description |
|---|---|---|
user_id | string | User ID to get jellies for. |
page | int | Page number. Default 1. |
page_size | int | Items per page. Default 15. Max 50. |
Access Levels
View — Full access. Hint — Minimal info for paid content (unauthenticated).
Response Attributes
| Attribute | Manage | View | Hint |
|---|---|---|---|
| access, id, participants, title, privacy | ✅ | ✅ | ✅ |
| video (hls_master, mp4_fallback) | ✅ | ✅ | ❌ |
| likes_count, comments_count, all_views | ✅ | ✅ | ❌ |
| price, pay_to_watch | ✅ | ✅* | ✅* |
Sample Response
{
"status": "success",
"jelly": {
"access": "hint",
"id": "01KJJZ227TCVE2YAMGPYEJR452",
"started_by_id": "7ec73234-1f3e-4051-8844-d08bc321b8fe",
"participants": [
{
"id": "7ec73234-1f3e-4051-8844-d08bc321b8fe",
"username": "Curatoroftheculture",
"full_name": "SHA ",
"pfp_url": "https://user-pfp.jellyjelly.com/.../image-min.jpeg"
}
],
"title": "Discussing Madam CJ Walker's Legacy as a Pioneer in Hair Care and Entrepreneurship",
"transcript_overlay": null,
"summary": null,
"privacy": "public",
"thumbnail_url": "https://dist.jellyjelly.com/.../thumbnail.jpeg?...",
"video": {
"original_duration": 51.1,
"preview_timecode": null,
"hls_master": null,
"mp4_fallback": null,
"mp4_preview": null
},
"likes_count": null,
"comments_count": null,
"all_views": null,
"distinct_views": null,
"anon_views": null,
"tips_total": null,
"posted_at": "2026-02-28T20:29:23.136Z",
"created_at": null,
"updated_at": null,
"deleted_at": null,
"price": 15,
"pay_to_watch": true,
"allow_preview": false,
"has_poll": null,
"has_event": null
}
}