Categories API
Categories are named spaces that hold your saved feeds. You can list them, rename them, or get them from your workspace.
GET/api/v1/categories
List all categories
Returns all of your categories and how many feeds are inside each one.
Request
GET/api/v1/categories
curl https://repurai.com/api/v1/categories \
-H "Authorization: Bearer [API_Key]"
Response
success
{
"data": [
{
"id": "b3c8f77e-cd66...",
"name": "Youtube",
"createdAt": "2025-12-24T18:31:02.411Z",
"updatedAt": "2025-12-24T18:31:02.411Z",
"feedCount": 9
}
]
}
GET/api/v1/categories/:id
Get a category
Returns a single category with all the feeds inside it.
Feed fields
| Field | Description |
|---|---|
id | The feed's unique ID. |
lastFetchedAt | When the feed was last checked for new posts. |
categoryId | The category ID this feed belongs to. |
title | The feed's display name. |
userlink | The feed source website homepage URL. |
description | A short description of the feed. |
favicon | URL of the feed's favicon. |
Request
GET/api/v1/categories/:id
curl https://repurai.com/api/v1/categories/[categoryId] \
-H "Authorization: Bearer [API_Key]"
Response
success
{
"data": {
"id": "b3c8f77e-cd66...",
"name": "Youtube",
"createdAt": "2025-12-24T18:31:02.411Z",
"updatedAt": "2025-12-24T18:31:02.411Z",
"feeds": [
{
"id": "2b3528dc-d64b...",
"lastFetchedAt": "2026-05-19T13:06:49.016Z",
"categoryId": "b3c8f77e-cd66...",
"title": "AI Engineer",
"userlink": "https://www.youtube.com/@aiDotEngineer",
"description": "Discover insights and updates from this source.",
"favicon": "https://t1.gstatic.com/faviconV2?client=SOCIAL&type=FAVICON&fallback_opts=TYPE,SIZE,URL&url=https://www.youtube.com/@aiDotEngineer&size=256"
}
]
}
}
PATCH/api/v1/categories/:id
Rename a category
Changes the display name of a category.
Required body
- Name
name- Type
- string
- Description
The new name for the category.
Request
PATCH/api/v1/categories/:id
curl -X PATCH https://repurai.com/api/v1/categories/[categoryId] \
-H "Authorization: Bearer [API_Key]" \
-H "Content-Type: application/json" \
-d '{"name": "API Test Category Renamed"}'
Response
success
{
"success": true,
"message": "Category renamed successfully",
"data": {
"id": "b3c8f77e-cd66...",
"name": "API Test Category Renamed"
}
}