Documentation Index
Fetch the complete documentation index at: https://api.docs.onlydrams.app/llms.txt
Use this file to discover all available pages before exploring further.
Query Parameters
Search communities by name (case-insensitive, partial match)
Filter communities by category: all, trending, or my_communities
Page number for pagination
Number of communities per page
Response
Total number of communities matching the query/filter
Whether there are more communities available
Array of community objects
Unique identifier for the community
Display name of the community
URL-friendly identifier for the community
Number of active members in the community
URL to the community’s avatar image (null if no avatar)
Name of the user’s membership tier if they are an active member (null if not a member)
Whether the current user is an active member of this community
Filter Options
| Filter | Description |
|---|
all | Returns all active communities (default) |
trending | Returns communities marked as trending |
my_communities | Returns only communities where the user has an active membership |
Frontend Usage
Use is_member and tier_badge to determine UI state:
| Condition | Button | Show Tier Badge |
|---|
is_member: true | ”View” | Yes (display tier_badge value) |
is_member: false | ”Explore” | No |
{
"total": 156,
"has_more": true,
"data": [
{
"id": "b2c3d4e5-6789-01ab-cdef-234567890abc",
"name": "RD One",
"slug": "rd-one",
"member_count": 650,
"avatar_url": "https://storage.onlydrams.com/communities/avatars/rd-one.png",
"tier_badge": "VIP",
"is_member": true
},
{
"id": "c3d4e5f6-7890-12ab-cdef-345678901abc",
"name": "Wine Community",
"slug": "wine-community",
"member_count": 650,
"avatar_url": "https://storage.onlydrams.com/communities/avatars/wine-community.png",
"tier_badge": "Basic",
"is_member": true
},
{
"id": "d4e5f6a7-8901-23ab-cdef-456789012abc",
"name": "Bourbon Enthusiasts",
"slug": "bourbon-enthusiasts",
"member_count": 1240,
"avatar_url": "https://storage.onlydrams.com/communities/avatars/bourbon-enthusiasts.png",
"tier_badge": null,
"is_member": false
},
{
"id": "e5f6a7b8-9012-34ab-cdef-567890123abc",
"name": "Scotch Lovers",
"slug": "scotch-lovers",
"member_count": 890,
"avatar_url": null,
"tier_badge": null,
"is_member": false
}
]
}
{
"total": 2,
"has_more": false,
"data": [
{
"id": "b2c3d4e5-6789-01ab-cdef-234567890abc",
"name": "RD One",
"slug": "rd-one",
"member_count": 650,
"avatar_url": "https://storage.onlydrams.com/communities/avatars/rd-one.png",
"tier_badge": "VIP",
"is_member": true
},
{
"id": "c3d4e5f6-7890-12ab-cdef-345678901abc",
"name": "Wine Community",
"slug": "wine-community",
"member_count": 650,
"avatar_url": "https://storage.onlydrams.com/communities/avatars/wine-community.png",
"tier_badge": "Basic",
"is_member": true
}
]
}
// GET /api/v1/communities/explore?query=bourbon
{
"total": 1,
"has_more": false,
"data": [
{
"id": "d4e5f6a7-8901-23ab-cdef-456789012abc",
"name": "Bourbon Enthusiasts",
"slug": "bourbon-enthusiasts",
"member_count": 1240,
"avatar_url": "https://storage.onlydrams.com/communities/avatars/bourbon-enthusiasts.png",
"tier_badge": null,
"is_member": false
}
]
}
