Skip to main content
GET
/
review-labels
cURL
curl --request GET \
  --url https://api.feedspace.io/v3/review-labels \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "id": "01krk3zwze14apa6gmx045ky8a",
      "name": "liked",
      "attributes": {
        "css_color_code": "#EA580C"
      },
      "reviews_count": 1
    }
  ]
}
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 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. 
curl -u "$API_KEY:$SECRET_KEY" \
  'https://api.feedspace.io/v3/review-labels?include[]=reviews_count'

​
Response

Returns a data array of label objects: 
{
  "data": [
    {
      "id": "01krk3zwze14apa6gmx045ky8a",
      "name": "liked",
      "attributes": {
        "css_color_code": "#EA580C"
      },
      "reviews_count": 1
    }
  ]
}
FieldTypeDescription
idstringLabel ID. Pass to filter[review-labels][] on GET /feeds.
namestringDisplay name of the label.
attributes.css_color_codestringHex colour used to render the label in the UI.
reviews_countintegerNumber 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: 
curl -u "$API_KEY:$SECRET_KEY" \
  'https://api.feedspace.io/v3/feeds?filter[review-labels][0]=01krk3zwze14apa6gmx045ky8a'
See List All Feeds for the full set of filters supported on the feeds endpoint.

Authorizations

​
Authorization
string
header
required

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).

Query Parameters

​
include[]
enum<string>[]

Optional related data to include on each label. Currently supported value: reviews_count (number of feeds tagged with this label).

Available options:
reviews_count

Response

200 - application/json

Review labels fetched successfully.

​
data
object[]