APIs

Categories

Category endpoints expose the browseable stream category catalog with parent relationships, image URLs, slugs, and display names. Every https://api.blaze.stream/v1 request on this page must include client-id: YOUR_CLIENT_ID.

List categories

GEThttps://api.blaze.stream/v1/categories

Returns categories in cursor-paginated pages of up to 200 rows. Each row includes id, parentId, imageUrl, slug, and name.

Required header for every https://api.blaze.stream/v1 request: client-id: YOUR_CLIENT_ID.

Authorizations

Query parameters

cursorstringoptional

Pagination cursor returned from the previous response.

limitinteger ยท max: 200optional

Maximum number of categories to return. Default and maximum: 200.

Responses

  • 200OKapplication/json
  • 400Bad Requestapplication/json
  • 401Unauthorizedapplication/json
  • 403Forbiddenapplication/json
  • 500Internal Server Errorapplication/json
GET/v1/categories
GET /v1/categories?limit=200 HTTP/1.1
Host: api.blaze.stream
Authorization: Bearer YOUR_ACCESS_TOKEN
client-id: YOUR_CLIENT_ID
Accept: application/json
200OK
{
  "success": true,
  "message": "success",
  "data": {
    "rows": [
      {
        "id": 12,
        "parentId": null,
        "imageUrl": "https://cdn.blaze.stream/uploads/categories/just-chatting.png",
        "slug": "just-chatting",
        "name": "Just Chatting"
      }
    ],
    "pagination": {
      "cursor": "NEXT_CURSOR"
    }
  }
}