Skip to main content
GET
cURL
Get a paginated list of all reviews across the workspace — text, audio, video, and social — in a single response. Use the query parameters below to narrow the results.

Filters

All filters are optional. Filters of different types are combined with AND; values within a single filter array are combined with OR. Supported query filters:
  • filter[search] — free-text keyword search across reviewer name and review text
  • filter[feed-types][] — review type (video, audio, text, social)
  • filter[favourite] — favourited reviews only (true)
  • filter[review_with_comment] — reviews with a non-empty comment (true)
  • filter[sentiments][] — AI-detected sentiment (positive, negative, neutral)
  • filter[star-rating][] — star rating (15)
  • filter[feed-forms][] — review form ID(s)
  • filter[review-labels][] — review label ID(s)
  • filter[imported-froms][] — import source platform ID(s)

filter[search]

Free-text keyword search. Matches the keyword as a case-insensitive substring against the reviewer’s name and the review text/comment, returning only reviews that contain it. Multi-word strings are matched literally — excellent service returns reviews containing that exact run of text. Encode the space as %20 or +.
Use filter[search]. The bare search query parameter has no effect on this endpoint and is silently ignored — no error is returned.
A keyword that matches nothing returns an empty result, so you can rely on this filter for client-side search without extra validation. This differs from filter[feed-types][] and filter[sentiments][], which silently drop unrecognised values and return the full unfiltered list.

filter[feed-types][]

Restrict results to specific review types. Allowed values: video, audio, text, social.
Pass only the values listed above. If you send an unknown value (e.g. a typo like vidoe), the filter is silently dropped and the API returns the full unfiltered list of reviews — not an error. Validate your input client-side before sending.
This filter matches by content type, not by the stored feed_type column. In particular, text returns any review that carries text content — including a social post that was imported with text (a social review can appear under the text filter). Likewise video matches imported social videos (social_feed_type: "manual_video") and audio matches imported social audio. Selecting social returns social reviews regardless of whether they contain text.

filter[favourite]

Return only favourited reviews. Pass true to enable; omit this parameter to include favourited and non-favourited reviews.

filter[review_with_comment]

Return only reviews that have a non-empty comment. Pass true to enable; omit this parameter to include reviews with or without comments.

filter[sentiments][]

Filter by AI-detected sentiment. Allowed values: positive, negative, neutral.
Pass only the values listed above. If you send an unknown value, the filter is silently dropped and the API returns the full unfiltered list of reviews — not an error. Validate your input client-side before sending.

filter[star-rating][]

Filter by star rating. Accepts integers from 1 through 5.
Pass only integers 15. Out-of-range values (e.g. 99) return an empty result, while non-numeric values (e.g. abc) are coerced to 0 and may return unrated items. Validate your input client-side.

filter[feed-forms][]

Filter to reviews collected via specific review forms. Pass the numeric form idnot unique_form_id. Get the numeric id from the List Review Forms endpoint — it is the integer id field on each form object.

filter[review-labels][]

Filter by review label ID(s). Label IDs are strings (e.g. 01krk3zwze14apa6gmx045ky8a). Get the available label IDs from the List Review Labels endpoint — use the id field from each label object.

filter[imported-froms][]

Filter to reviews imported from specific source platforms (Google, YouTube, Wistia, Product Hunt, etc.). Accepts numeric platform IDs.
A public listing endpoint for import-platform IDs is on the roadmap. Until then, contact support to obtain the ID mapping for the platforms relevant to your workspace.

Pagination

Results are paginated with 15 items per page. Use ?page= to navigate.
The response includes first_page_url, next_page_url, and prev_page_url. next_page_url is null on the last page; prev_page_url is null on the first.

Combining filters

Mix any of the above; a keyword search combines with the other filters the same way (AND). The example below requests positive-sentiment reviews that mention Dewalt:
This next example requests favourited video- or audio-type reviews with positive sentiment, a 4- or 5-star rating, and a non-empty comment:

URL encoding the brackets

The filter[...] syntax contains literal [ and ]. Most HTTP clients (Postman, Python requests, JavaScript fetch, Insomnia) handle this transparently. Two things to watch for:
  • curl interprets [ and ] as URL-globbing ranges by default. Add the -g flag (alias --globoff) — or URL-encode as %5B and %5D — to suppress that behaviour:
  • Browsers / fully-encoded clients will accept the percent-encoded form too:

Response shape

Each item in data.data[] carries a top-level feed_type (audio_feed, video_feed, text_feed, or social_feed) which determines which type-specific block is present on the item:
  • feed_type: "audio_feed"audio_feed block with file_url, transcript, etc.
  • feed_type: "video_feed"video_feed block with file_url, static_thumb_url, transcript, etc.
  • feed_type: "text_feed"text_feed block with the review text content.
  • feed_type: "social_feed"social_feed block with social_platform, attachments, plus a social_feed_type field on the item (social, manual_text, manual_video) that indicates the sub-category.
All items also include review_labels (an array of { id, name, attributes } objects) — possibly empty.

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

Free-text keyword search. Matches the keyword (case-insensitive substring) against the reviewer's name and the review text/comment, returning only reviews that contain it. Multi-word strings are matched literally (encode spaces as %20 or +). An unmatched keyword returns an empty result. Note: the bare search query parameter has no effect on this endpoint — use filter[search].

filter[feed-types][]
enum<string>[]

Restrict to specific review types. Values: audio, video, text, social. Repeat the parameter to combine multiple types (OR). Reviews are matched by the media they carry, not by their stored feed_type, so a returned item's feed_type can differ from the value you filtered on. For example, a social review that has a video attachment (such as an imported Instagram or YouTube video) is returned by video even though its feed_type is social_feed. In full: video and audio return native video/audio reviews plus any social review that carries a video or audio attachment; text returns native text reviews (feed_type: text_feed) plus text reviews you added manually (stored as feed_type: social_feed). Reviews collected from connected platforms or web link imports that only contain text are returned by social, not text.

Available options:
audio,
video,
text,
social
filter[favourite]
enum<string>

Return only favourited reviews. Pass true to enable; omit to include all reviews.

Available options:
true
filter[review_with_comment]
enum<string>

Return only reviews that have a non-empty comment. Pass true to enable; omit to include all reviews.

Available options:
true
filter[sentiments][]
enum<string>[]

Filter by AI-detected sentiment. Repeat the parameter to combine multiple values (OR).

Available options:
positive,
negative,
neutral
filter[star-rating][]
integer[]

Filter by star rating. Send one or more values from 1 to 5; the filter matches the inclusive range between the lowest and highest values you send (for example, 2 and 4 matches 2, 3 and 4).

Required range: 1 <= x <= 5
filter[feed-forms][]
integer[]

Filter to reviews collected via specific review forms. Pass the numeric form ID (the integer id from GET /forms, not unique_form_id).

filter[review-labels][]
string[]

Filter by review label ID(s). Use the id field returned by GET /review-labels as the value.

filter[imported-froms][]
integer[]

Filter to reviews imported from specific source platforms. Accepts numeric platform IDs. A public listing endpoint for these IDs is on the roadmap.

page
integer

Page number (default: 1). The response is paginated with 15 items per page.

Response

200 - application/json

Reviews list fetched successfully.

data
object
show_migration_banner
boolean

Whether to show migration banner

show_updated_banner
boolean
updated_banner_video
string
show_workspaces_merge_banner
boolean
unique_form_id
string
marketing_materials
integer

Count of marketing materials