feed

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).

get/v1/feed

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
Auth
none declared

Query parameters

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
}

Changes

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