Skip to main content
GET
cURL
Get a paginated list of all text reviews received.

Query Parameters

  • filter[feed-types][] (required): Set to "text" to filter text reviews
  • page (optional): Page number for pagination (default: 1)

Example Request

Response

Returns a paginated list of text reviews with reviewer details, question answers, and other details.

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