Get aggregated tipped content feed

Returns aggregated tip destinations with optional content enrichment. Each item represents a unique URL that has been tipped, with tip counts, total amounts, and optionally enriched metadata (title, description, thumbnail).

sort'popular' | 'new'

Sort order: 'popular' (by total USD) or 'new' (by most recent tip).

window'24h' | '7d' | '30d' | 'all'

Time window: '24h', '7d', '30d', or 'all' (all time).

platformstring nullable

Filter by platform (e.g., 'youtube', 'reddit', 'bluesky', 'medium'). Omit for all platforms.

enrichboolean

If true, enrich items with content metadata (title, description, thumbnail).

limitinteger

Maximum number of items per page.

cursorstring nullable

Opaque cursor for pagination. Pass the cursor from the previous response to get the next page.

Response

Successful Response

cursorstring nullable

Opaque cursor for fetching the next page. Null if no more results.

has_moreboolean

Whether more results exist beyond this page.

total_countinteger required

Total number of unique tipped URLs matching the filter.

Example response

{
  "items": [
    {
      "url": "https://www.youtube.com/watch?v=abc123",
      "platform": "youtube",
      "tip_count": 42,
      "total_amount_usd": "125.50",
      "unique_tippers": 18,
      "last_tipped_at": "2026-03-22T14:30:00Z",
      "content": {
        "title": "The Bull Case for Ethereum in 2026",
        "description": "Ryan and David break down why ETH could outperform...",
        "image_url": "https://i.ytimg.com/vi/abc123/hqdefault.jpg",
        "author_name": "Bankless",
        "published_at": "2026-03-22T08:15:00Z"
      },
      "enrichment_status": "cached",
      "source": "discovered",
      "creator_handle": "alice",
      "creator_avatar_url": "https://pbs.twimg.com/profile_images/abc/photo.jpg",
      "embed_id": "dQw4w9WgXcQ"
    }
  ],
  "total_count": 1234
}

v1

Get aggregated tipped content feed

Query parameters

Response

Example response