Skip to content

List Categories

Get all available content categories.

GET/v1/categories

Overview

Retrieve a list of all available content categories for organizing feeds.

Authentication

Required: No
Payment: No

Public endpoint - no authentication needed.

Parameters

None

Response

Status: 200 OK

{
  "data": [
    {
      "id": "string",
      "name": "string", 
      "description": "string"
    }
  ],
  "pagination": {
    "page_size": 20,
    "next_page_token": null,
    "has_more": false
  }
}

Code Examples

cURL

curl https://api.grapevine.fyi/v1/categories

SDK

import { GrapevineClient } from '@pinata/grapevine-sdk';
 
const grapevine = new GrapevineClient();
const categories = await grapevine.categories.getAll();
console.log(categories);

External Playground

Try this endpoint interactively in Swagger UI:
https://api.grapevine.fyi/v1/docs