List Feeds

Retrieve a paginated list of feeds with filtering options.

GET/v1/feeds

Overview

Retrieve cursor-paginated feeds with filtering by owner, category, tags, entry count, age, and active status. Ordered by created_at DESC (newest first).

Authentication: Not required
Payment: Not required

Request

Query Parameters

Parameter	Type	Default	Description
`page_size`	integer	20	Items per page (max 100)
`page_token`	string	-	Pagination cursor
`owner_wallet_address`	string	-	Filter by owner wallet
`category`	string (UUID)	-	Filter by category
`tags`	string	-	Filter by tag (repeatable)
`min_entries`	integer	1	Minimum entries
`is_active`	boolean	-	Filter by status

Response

{
  "data": [
    {
      "id": "feed-uuid",
      "owner_wallet_address": "0x742d35Cc...",
      "name": "Tech Blog",
      "description": "Latest tech articles",
      "total_entries": 25,
      "total_purchases": 150,
      "total_revenue": "150000000",
      "tags": ["tech", "programming"],
      "is_active": true,
      "created_at": 1734192000
    }
  ],
  "pagination": {
    "page_size": 20,
    "next_page_token": "cursor-string",
    "has_more": true
  }
}

Code Examples

cURL

# Basic
curl https://api.grapevine.fyi/v1/feeds
 
# With filters
curl "https://api.grapevine.fyi/v1/feeds?is_active=true&min_entries=10"
 
# By owner
curl "https://api.grapevine.fyi/v1/feeds?owner_wallet_address=0x742d35Cc..."
 
# By tags (AND logic)
curl "https://api.grapevine.fyi/v1/feeds?tags=tech&tags=ai"

Pagination

Use cursor-based pagination:

Make initial request
Get next_page_token from response
Use in next request with page_token
Continue until has_more is false