Skip to main content
GET
Get Community Feed

Overview

The Community Feed endpoint returns a paginated, filterable list of community-shared content, including both sessions and individual media items. Results can be filtered by content type, creator, subreddit, category, tags, and search terms.

Authentication

This endpoint requires authentication. Include a valid session cookie or authentication header.

Query Parameters

string
default:"all"
Filter by content type:
  • all - Both sessions and media
  • sessions - Only session snapshots
  • captions - Only smart caption media
  • babecuts - Only babecock media
  • hypnococks - Only hypnococks media
  • betacensors - Only beta censor media
string
default:"new"
Sort order:
  • new - Most recent first
  • hot - Engagement-weighted recency (combines likes and recency)
  • top - Highest likes first
Search across titles, captions, creator names, and filenames
string
Filter by creator name or email (partial match)
string
Filter by exact creator user ID
string
Filter sessions by subreddit name (partial match)
string
Filter media by character name (partial match)
number
Filter by category ID
string
Filter by category slug
string
Comma-separated list of tag slugs to filter by Example: joi,femdom,hypno
string
default:"or"
Tag matching mode:
  • or - Match any of the specified tags
  • and - Match all specified tags
number
default:"1"
Page number (1-indexed)
number
default:"20"
Number of items per page (1-100)

Response

array
Array of community content items (sessions and media)
number
Total number of items matching the filter criteria
number
Current page number
number
Items per page
number
Total number of pages

Examples

Get Recent Sessions

Search for Content

Filter by Creator and Category

Filter by Multiple Tags (AND mode)

Get Top Babecock Media

Response Example

Notes

  • The hot sort combines likes and recency using the formula: (likes + 1) / (age_in_hours + 2)^1.5
  • When contentType=all, results merge sessions and media, sorted by createdAt
  • Tag filtering applies separately to sessions and media, then merges results
  • Admin users can see isHidden content; non-admins see only non-hidden items
  • Character filtering only applies to media items
  • Subreddit filtering only applies to sessions