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
}

Documentation Index

Fetch the complete documentation index at: https://docs.feedspace.io/llms.txt

Use this file to discover all available pages before exploring further.

Get a paginated list of all audio feeds received.

Query Parameters

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

Example Request

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

Response

Returns a paginated list of audio 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[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