Reviews

Retrieve reviews with filtering, pagination, and sorting options.

Get Reviews

GET/api/v1/public/reviews

Legacy: /api/reviews is still supported (redirects to /api/v1/public/reviews)

Retrieves reviews (Public API, API key required).

Headers:

x-api-key: YOUR_API_KEY

Query Parameters:

  • limit (number, default: 10, max: 100) - Number of reviews
  • minRating (number) - Minimum rating (1-5)
  • sentiment (string) - Filter by sentiment (positive|neutral|negative)
  • language (string) - Filter by language (e.g. "de", "en")
  • sourceId (string) - Filter by Source ID

Examples:

Get latest 10 reviews
curl https://api.proofio.app/api/v1/public/reviews \
  -H "x-api-key: YOUR_API_KEY"
Only positive reviews with min. 4 stars
curl "https://api.proofio.app/api/v1/public/reviews?sentiment=positive&minRating=4" \
  -H "x-api-key: YOUR_API_KEY"
Legacy (still supported)
curl https://api.proofio.app/api/reviews \
  -H "x-api-key: YOUR_API_KEY"

Response:

Response
[
  {
    "id": "clx...",
    "projectId": "clx...",
    "sourceId": "clx...",
    "rating": 5,
    "text": "Fantastische App!",
    "title": "Sehr gut",
    "authorName": "MaxMustermann",
    "authorAvatar": null,
    "language": "de",
    "date": "2026-02-07T19:39:27...",
    "sentiment": "positive",
    "verified": true
  }
]