All Social Reviews
Get a paginated list of reviews across the workspace. Supports optional filters: filter[search], filter[feed-types][], filter[favourite], filter[review_with_comment], filter[sentiments][], filter[star-rating][], filter[feed-forms][], filter[review-labels][], and filter[imported-froms][]. All filters are optional; filters of different types are AND-combined, while values within a single filter array are OR-combined (except filter[star-rating][], which matches the inclusive range between the lowest and highest values sent).
Query Parameters
filter[feed-types][](required): Set to"social"to return social reviewspage(optional): Page number for pagination (default: 1)
Example Request
text filter.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
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].
Restrict to specific review types. Values: audio, video, text, social. Repeat the parameter to combine multiple types (OR). This filter matches by content type, not by the stored feed_type column: text returns any review that has text content, so an imported social post that carries text is included. The video value likewise matches imported social videos (social_feed_type: manual_video), and audio matches imported social audio.
audio, video, text, social Return only favourited reviews. Pass true to enable; omit to include all reviews.
true Return only reviews that have a non-empty comment. Pass true to enable; omit to include all reviews.
true Filter by AI-detected sentiment. Repeat the parameter to combine multiple values (OR).
positive, negative, neutral 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).
1 <= x <= 5Filter to reviews collected via specific review forms. Pass the numeric form ID (the integer id from GET /forms, not unique_form_id).
Filter by review label ID(s). Use the id field returned by GET /review-labels as the value.
Filter to reviews imported from specific source platforms. Accepts numeric platform IDs. A public listing endpoint for these IDs is on the roadmap.
Page number (default: 1). The response is paginated with 15 items per page.
Response
Reviews list fetched successfully.