Get Feed

Retrieve detailed information about a specific feed.

GET/v1/feeds/{feed_id}

Overview

Retrieve complete information about a feed including statistics, owner details, and metadata.

Authentication

Required: No
Payment: No

Public endpoint - no authentication needed.

Request

Path Parameters

Parameter	Type	Required	Description
`feed_id`	string (UUID)	Yes	Feed identifier

Example

GET /v1/feeds/123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: api.grapevine.fyi

Response

Status: 200 OK

{
  "id": "feed-uuid",
  "owner_id": "owner-uuid",
  "owner_wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "category_id": "category-uuid",
  "name": "Tech Blog",
  "description": "Latest tech articles and tutorials",
  "image_cid": "QmX...",
  "is_active": true,
  "total_entries": 125,
  "total_purchases": 450,
  "total_revenue": "450000000",
  "tags": ["tech", "programming", "tutorial"],
  "created_at": 1734192000,
  "updated_at": 1734192000
}

Code Examples

cURL

curl https://api.grapevine.fyi/v1/feeds/123e4567-e89b-12d3-a456-426614174000

JavaScript

const response = await fetch(
  `https://api.grapevine.fyi/v1/feeds/${feedId}`
);
const feed = await response.json();
console.log(feed.name, `(${feed.total_entries} entries)`);

Python

import requests
 
response = requests.get(
    f'https://api.grapevine.fyi/v1/feeds/{feed_id}'
)
feed = response.json()
print(f"{feed['name']} ({feed['total_entries']} entries)")

SDK

import { GrapevineClient } from '@pinata/grapevine-sdk';
 
const grapevine = new GrapevineClient({ network: 'mainnet' });
const feed = await grapevine.feeds.get(feedId);

CLI

grapevine feed get {feed_id}

Response Fields

Field	Type	Description
`total_entries`	integer	Number of entries in feed
`total_purchases`	integer	Total purchases across all entries
`total_revenue`	string	Total revenue in USDC units

Related Endpoints

External Playground

Try this endpoint interactively:
https://api.grapevine.fyi/v1/docs#/Feeds/get_v1_feeds__feed_id_