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. An optional term query parameter narrows results by search term. 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.

termstringoptional

Search term used to narrow category results.

Responses

  • 200OKapplication/json
  • 400Bad Requestapplication/json
  • 401Unauthorizedapplication/json
  • 403Forbiddenapplication/json
  • 500Internal Server Errorapplication/json
GET/v1/categories
GET /v1/categories?limit=200&term=chat 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"
    }
  }
}