How Do I Fetch Reviews Using the Feedspace API?

Overview

The Feedspace REST API lets you programmatically retrieve reviews from your workspace. You can use this to display approved reviews in a custom widget on your website, sync reviews to a CRM, or build a review dashboard, all without touching the Feedspace dashboard.

This article walks you through generating your API key and making your first GET request to the reviews endpoint.

Prerequisites

• A Feedspace account on the Professional or Business plan
• Access to a terminal, API client (such as Postman), or your own application code

Step 1: Generate Your API Key

1. Log in to Feedspace.
2. In the left sidebar, click Automation.
3. Click the API tab at the top of the Automation page.
4. Click Generate to create a new API key and secret key.
5. Copy the API Key. You will use it as the value for the Authorization header in every API request.

Keep your API key secure. Do not expose it in client-side JavaScript or commit it to a public repository.

Step 2: Make a GET Request to the Reviews Endpoint

Send a GET request to the reviews endpoint with your API key in the Authorization header. The example below uses curl:

curl -X GET "https://www.feedspace.io/api/v1/reviews" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Replace YOUR_API_KEY with the key you copied in Step 1.

Step 3: Filter and Paginate the Results

The reviews endpoint supports query parameters so you can narrow down the results returned:

• status: Filter by review status. Use status=approved to retrieve only published reviews.
• limit: Set the maximum number of reviews returned per request (for example, limit=20).
• page: Paginate through results by incrementing the page number (for example, page=2).

Example request fetching the first 20 approved reviews:

curl -X GET "https://www.feedspace.io/api/v1/reviews?status=approved&limit=20&page=1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Step 4: Read the JSON Response

A successful response returns a JSON array of review objects. Each object includes fields such as:

• id: Unique identifier for the review
• reviewer_name: Full name of the person who submitted the review
• rating: Numeric rating given by the reviewer
• text: The written review content
• created_at: Timestamp of when the review was submitted
• status: Current status of the review (for example, approved, pending)

Sample response:

[
  {
    "id": "rev_001",
    "reviewer_name": "Jane Smith",
    "rating": 5,
    "text": "Absolutely love using Feedspace to collect testimonials!",
    "created_at": "2026-06-01T10:30:00Z",
    "status": "approved"
  },
  {
    "id": "rev_002",
    "reviewer_name": "Mark Johnson",
    "rating": 4,
    "text": "Great tool for gathering customer feedback quickly.",
    "created_at": "2026-06-02T14:15:00Z",
    "status": "approved"
  }
]

Common Use Cases

• Custom review widget: Pull approved reviews via the API and render them directly on your website without embedding an iframe.
• CRM sync: Send review data to your CRM on a schedule so your sales or support team always has the latest customer feedback.
• Review dashboard: Aggregate reviews from multiple Feedspace forms into a single internal dashboard for reporting and analysis.

Troubleshooting

• 401 Unauthorized: Your API key is missing or incorrect. Double-check the value in the Authorization header.
• 403 Forbidden: Your plan does not include API access. Upgrade to the Professional or Business plan in Feedspace.
• Empty results array: No reviews match the filters you applied. Try removing the status filter to confirm reviews exist in your workspace.