Skip to main content
GET
/
feeds
cURL
curl --request GET \
  --url https://api.feedspace.io/v3/feeds \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": {
    "current_page": 1,
    "data": [
      {
        "feed_type": "audio_feed",
        "id": 544,
        "unique_feedback_id": "qrTTi2",
        "comment": null,
        "favourite": 0,
        "is_locked": 0,
        "is_video_converted": null,
        "is_audio_converted": 1,
        "customer_designation": null,
        "created_at": "2025-04-07T08:50:44.000000Z",
        "feed_fields": {
          "name": "Prajakta Managuli",
          "profile_pic_url": null,
          "position": "Content Writer",
          "organization_name": "Techuplabs",
          "consent": null
        },
        "audio_feed": {
          "is_audio_converted": 1,
          "transcript": null,
          "file_url": "https://dm219012nbq21.cloudfront.net/uploads/zhBU6t/audio-feed/feed_zhBU6t1744015722679.mp3"
        },
        "is_download_enabled": false
      }
    ],
    "first_page_url": "https://api.feedspace.io/v3/feeds?page=1",
    "from": 1,
    "next_page_url": null,
    "path": "https://api.feedspace.io/v3/feeds",
    "per_page": 15,
    "prev_page_url": null,
    "to": 2
  },
  "show_migration_banner": false,
  "show_updated_banner": false,
  "updated_banner_video": "https://feedspace-test.s3.ap-south-1.amazonaws.com/uploads/F43kUl/video-feed/feed_MJcmzA81710841191347.mp4",
  "show_workspaces_merge_banner": false,
  "unique_form_id": "form_gSgElcsXX8LaI6RtMA6JqlkN",
  "marketing_materials": 0
}
Get a paginated list of all text feeds received.

​
Query Parameters

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

​
Example Request

GET /feeds?filter[feed-types][]=text&page=1

​
Response

Returns a paginated list of text feeds with feed fields, 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

​
filter[search]
string

Free-text keyword search. Matches the keyword (case-insensitive substring) against the reviewer's name and the review text/comment, returning only feeds 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 feed types. Repeat the parameter to combine multiple types (OR). The 'video' value also matches imported social videos (social_feed_type: manual_video); the same applies to other types.

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

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

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

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

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 (1 through 5). Repeat the parameter to combine multiple values (OR).

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

Filter to feeds 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 feeds 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

Feeds 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