> ## Documentation Index
> Fetch the complete documentation index at: https://docs.feedspace.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Review Labels

> Get all review labels defined in the workspace. Use the `id` returned by this endpoint as the value for `filter[review-labels][]` on GET /feeds.

Get all review labels defined in the workspace. Each label has a stable `id` that you can pass to `filter[review-labels][]` on [`GET /feeds`](/api-reference/Feeds/list-feeds) to fetch all feeds tagged with that label.

## Query Parameters

### `include[]`

Optional. Pass `reviews_count` to include the number of feeds tagged with each label.

```bash theme={null}
curl -u "$API_KEY:$SECRET_KEY" \
  'https://api.feedspace.io/v3/review-labels?include[]=reviews_count'
```

## Response

Returns a `data` array of label objects:

```json theme={null}
{
  "data": [
    {
      "id": "01krk3zwze14apa6gmx045ky8a",
      "name": "liked",
      "attributes": {
        "css_color_code": "#EA580C"
      },
      "reviews_count": 1
    }
  ]
}
```

| Field                       | Type    | Description                                                                                   |
| --------------------------- | ------- | --------------------------------------------------------------------------------------------- |
| `id`                        | string  | Label ID. Pass to `filter[review-labels][]` on `GET /feeds`.                                  |
| `name`                      | string  | Display name of the label.                                                                    |
| `attributes.css_color_code` | string  | Hex colour used to render the label in the UI.                                                |
| `reviews_count`             | integer | Number of feeds tagged with this label. Only present when `include[]=reviews_count` was sent. |

## Using a label ID

Once you have a label `id`, fetch all feeds tagged with it:

```bash theme={null}
curl -u "$API_KEY:$SECRET_KEY" \
  'https://api.feedspace.io/v3/feeds?filter[review-labels][0]=01krk3zwze14apa6gmx045ky8a'
```

See [List All Feeds](/api-reference/Feeds/list-feeds) for the full set of filters supported on the feeds endpoint.


## OpenAPI

````yaml GET /review-labels
openapi: 3.1.0
info:
  title: Feedspace API
  description: Feedspace API v3 - Feedback and testimonial management platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.feedspace.io/v3
security: []
paths:
  /review-labels:
    get:
      tags:
        - ReviewLabels
      description: >-
        Get all review labels defined in the workspace. Use the `id` returned by
        this endpoint as the value for `filter[review-labels][]` on GET /feeds.
      parameters:
        - name: include[]
          in: query
          description: >-
            Optional related data to include on each label. Currently supported
            value: `reviews_count` (number of feeds tagged with this label).
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - reviews_count
      responses:
        '200':
          description: Review labels fetched successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: >-
                            Label ID. Pass this to filter[review-labels][] on
                            GET /feeds.
                        name:
                          type: string
                          description: Display name of the label.
                        attributes:
                          type: object
                          properties:
                            css_color_code:
                              type: string
                              description: >-
                                Hex colour code used to render the label in the
                                UI.
                        reviews_count:
                          type: integer
                          description: >-
                            Number of feeds tagged with this label. Only present
                            when include[]=reviews_count was passed.
              examples:
                success:
                  value:
                    data:
                      - id: 01krk3zwze14apa6gmx045ky8a
                        name: liked
                        attributes:
                          css_color_code: '#EA580C'
                        reviews_count: 1
      security:
        - basicAuth: []
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        HTTP Basic Authentication using API Key and Secret Key. The credentials
        should be Base64 encoded in the format 'api_key:secret_key'. You can
        obtain your API Key and Secret Key from Feedspace → Automation → API
        (https://app.feedspace.io/automation/api).

````