Skip to content

categories

List all available content categories for organizing feeds.

Usage

grapevine categories [options]

Options

--stats

  • Type: boolean
  • Default: false

Include statistics for each category (feed count, entry count, etc.).

grapevine categories --stats

--popular

  • Type: boolean
  • Default: false

Sort categories by popularity (most feeds/entries first).

grapevine categories --popular

-q, --query

  • Type: string

Search categories by name or description.

grapevine categories --query "tech"

Examples

List All Categories

grapevine categories

Categories with Statistics

grapevine categories --stats

Popular Categories

grapevine categories --popular --stats

Search Categories

grapevine categories --query "programming"

Output

Basic Output

📂 Content Categories
 
🏷️  Technology - cat-123e4567-e89b-12d3-a456-426614174000
    Tech-related content including programming, software, and hardware
 
🏷️  Business - cat-456e7890-abcd-12d3-ef45-426614174001
    Business strategies, entrepreneurship, and market analysis
 
🏷️  Health & Fitness - cat-789eabcd-1234-56d3-7890-426614174002
    Health tips, fitness routines, and wellness advice
 
🏷️  Education - cat-abcd1234-5678-90d3-abcd-426614174003
    Educational content, tutorials, and learning resources
 
🏷️  Entertainment - cat-efgh5678-9012-34d3-efgh-426614174004
    Movies, music, games, and entertainment news
 
🏷️  Personal Development - cat-ijkl9012-3456-78d3-ijkl-426614174005
    Self-improvement, productivity, and life skills
 
🏷️  Travel - cat-mnop3456-7890-12d3-mnop-426614174006
    Travel guides, destinations, and cultural experiences
 
🏷️  Food & Cooking - cat-qrst7890-1234-56d3-qrst-426614174007
    Recipes, cooking techniques, and culinary adventures
 
Total: 8 categories

With Statistics

📂 Content Categories (sorted by popularity)
 
🏷️  Technology - cat-123e4567...
    Tech-related content including programming, software, and hardware
    📊 Statistics:
       • Feeds: 1,247 (18.5% of total)
       • Entries: 15,892 (22.1% of total)
       • Total Revenue: $12,847.50 USDC
       • Avg Entry Price: $0.81 USDC
       • Most Active: Last 24h (347 new entries)
 
🏷️  Business - cat-456e7890...
    Business strategies, entrepreneurship, and market analysis
    📊 Statistics:
       • Feeds: 892 (13.2% of total)
       • Entries: 8,234 (11.4% of total)
       • Total Revenue: $18,234.75 USDC
       • Avg Entry Price: $2.21 USDC
       • Most Active: Last 24h (89 new entries)
 
🏷️  Education - cat-abcd1234...
    Educational content, tutorials, and learning resources
    📊 Statistics:
       • Feeds: 734 (10.9% of total)
       • Entries: 12,456 (17.3% of total)
       • Total Revenue: $3,892.25 USDC
       • Avg Entry Price: $0.31 USDC
       • Most Active: Last 24h (234 new entries)
 
[... more categories ...]
 
Total: 8 categories • 6,743 total feeds • 71,892 total entries

Search Results

grapevine categories --query "tech"
📂 Categories matching "tech"
 
🏷️  Technology - cat-123e4567...
    Tech-related content including programming, software, and hardware
 
🏷️  Fintech - cat-xyz12345...
    Financial technology, blockchain, and digital payments
 
Found 2 matching categories

Authentication

No authentication required to view categories.

Using Category IDs

Categories are used when creating or updating feeds:

# Get category ID
grapevine categories | grep "Technology"
# Output: Technology - cat-123e4567-e89b-12d3-a456-426614174000
 
# Use in feed creation
grapevine feed create "My Tech Blog" --category "cat-123e4567-e89b-12d3-a456-426614174000"
 
# Use in feed updates
grapevine feed update "feed-id" --category "cat-123e4567-e89b-12d3-a456-426614174000"

Category Guidelines

Choosing the Right Category

  1. Be Specific: Choose the most specific category that fits your content
  2. Primary Focus: Select based on your feed's primary theme
  3. Audience Targeting: Consider what category your target audience browses
  4. Content Discovery: Categories affect how users discover your content

Category Descriptions

Each category includes:

  • Name: Clear, descriptive category name
  • UUID: Unique identifier for API/CLI usage
  • Description: Detailed explanation of category scope
  • Usage Stats: Number of feeds and entries (when using --stats)

Content Organization Tips

# Research category popularity before creating feeds
grapevine categories --popular --stats
 
# Find the best category for your niche
grapevine categories --query "your topic"
 
# Browse successful feeds in your category
grapevine feed list --category "cat-uuid" --sort popular

Notes

  • Static List: Categories are curated and managed by the platform
  • No Custom Categories: Users cannot create custom categories
  • Single Category: Each feed belongs to exactly one category
  • Category Migration: Feed categories can be updated after creation

Related Commands