v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
feed

Get creator's cross-platform content feed

Discover recent content from a creator's linked social accounts.

Returns a unified feed of content from YouTube, Bluesky, Reddit, Medium, Substack, and GitHub — merged with tip signals from existing data.

Fan-out on demand: no persistent storage. Content is fetched live from platform RSS/Atom/API feeds and cached briefly.

This is a public endpoint - no authentication required.

get/v1/feed/creators/{handle}

Path parameters

handlestring required

Creator's Grove handle

Creator's Grove handle

Query parameters

platformsstring[] nullable

Filter to specific platforms (e.g., youtube, bluesky)

Filter to specific platforms (e.g., youtube, bluesky)

sort'recent' | 'tipped'

Sort order: 'recent' or 'tipped'

Sort order: 'recent' or 'tipped'

enrichboolean

Include content metadata enrichment

Include content metadata enrichment

limitinteger

Max items to return

Max items to return

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
}