Get all review labels
curl --request GET \
--url https://api.feedspace.io/v3/review-labels \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.feedspace.io/v3/review-labels"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.feedspace.io/v3/review-labels', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.feedspace.io/v3/review-labels",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.feedspace.io/v3/review-labels"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.feedspace.io/v3/review-labels")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.feedspace.io/v3/review-labels")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "01krk3zwze14apa6gmx045ky8a",
"name": "liked",
"description": null,
"attributes": {
"css_color_code": "#EA580C"
},
"reviews_count": 1
}
]
}Review Labels
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
/
review-labels
Get all review labels
curl --request GET \
--url https://api.feedspace.io/v3/review-labels \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.feedspace.io/v3/review-labels"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.feedspace.io/v3/review-labels', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.feedspace.io/v3/review-labels",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.feedspace.io/v3/review-labels"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.feedspace.io/v3/review-labels")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.feedspace.io/v3/review-labels")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "01krk3zwze14apa6gmx045ky8a",
"name": "liked",
"description": null,
"attributes": {
"css_color_code": "#EA580C"
},
"reviews_count": 1
}
]
}Get all review labels defined in the workspace. Each label has a stable
Optional. Pass
See List All Reviews for the full set of filters supported on the reviews list endpoint.
id that you can pass to filter[review-labels][] on GET /feeds to fetch all reviews tagged with that label.
Query Parameters
include[]
Optional. Pass reviews_count to include the number of reviews tagged with each label.
An unrecognised value is ignored rather than rejected. A typo such as
include[]=review_count returns 200 with the label objects and no reviews_count field, which reads like a workspace with no counts instead of an error. Confirm the field is present before relying on it.curl -g -u "$API_KEY:$SECRET_KEY" \
'https://api.feedspace.io/v3/review-labels?include[]=reviews_count'
Response
Returns adata array of label objects:
{
"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. |
description | string | Optional description of the label. Null if not set. |
attributes.css_color_code | string | Hex colour used to render the label in the UI. |
reviews_count | integer | Number of reviews tagged with this label. Only present when include[]=reviews_count was sent. |
Using a label ID
Once you have a labelid, fetch all reviews tagged with it:
curl -g -u "$API_KEY:$SECRET_KEY" \
'https://api.feedspace.io/v3/feeds?filter[review-labels][0]=01krk3zwze14apa6gmx045ky8a'
Authorizations
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
Optional related data to include on each label. Currently supported value: reviews_count (number of reviews tagged with this label). An unrecognised value is ignored rather than rejected, and the field is simply absent from the response.
Available options:
reviews_count Response
200 - application/json
Review labels fetched successfully.
Show child attributes
Show child attributes