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}

Request

Base URL
https://api.grove.city (the document declares no server; this is the origin it was published from)
URL
https://api.grove.city/v1/feed/creators/{handle}
Auth
none declared

Path parameters

handlestring required

Creator's Grove handle

Query parameters

platformsstring[] nullable

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

sort'recent' | 'tipped'

Sort order: 'recent' or 'tipped'

enrichboolean

Include content metadata enrichment

limitinteger

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
}

Changes

No recorded changes to this operation across all 1 revision of this API.