Skip to main content
GET
cURL
Get a paginated list of social reviews received — testimonials imported from social platforms (G2, Trustpilot, Product Hunt, etc.) and manual or web-link imports stored as social records.

Query Parameters

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

Example Request

See List All Reviews for every supported filter, and note that the type filter matches by content: a social review that carries text also appears under the text filter.

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

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