API Reference

Sentric API

Push reviews from any source and retrieve structured feedback via stable, authenticated REST endpoints.

Authentication

All requests require an API key in the Authorization header.

Header

Authorization: Bearer your-api-key

Generate keys in dashboard → Settings → API Keys.

Endpoints

POST

/api/reviewsrequires reviews:write

Ingest one or more reviews for a product. Reviews are queued for AI analysis automatically.

Required: product_id, review_text, rating, review_date

Optional: reviewer_name, review_title, source_id, metadata

Batch: wrap multiple reviews in an array under the reviews key

GET

/api/reviewsrequires reviews:read

Retrieve reviews with pagination, full-text search, and filter support.

Required: product_id

Pagination: page (default 1), limit (default 20, max 100)

Sort: sort_by (review_date | rating | created_at), sort_order (asc | desc)

Filters: min_rating, max_rating, source_platform, search, start_date, end_date

Code examples

Switch between endpoints and languages. Toggle to full for responses.

View:

POST /api/reviews — cURL

curl -X POST "https://api.thesentric.com/api/reviews" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "product_id": "your-product-id",
    "review_text": "The onboarding experience is seamless.",
    "rating": 5,
    "review_date": "2025-04-19T08:00:00Z",
    "reviewer_name": "Amara Osei",
    "review_title": "Genuinely impressed"
  }'

Example response

{
  "success": true,
  "message": "Successfully added 1 review(s)",
  "reviews_added": 1,
  "reviews": [
    {
      "id": "8e4b12c3-...",
      "product_platform_id": "d7f9a...",
      "rating": 5,
      "review_date": "2025-04-19T08:00:00.000Z",
      "source_id": "api-your-product-id-..."
    }
  ]
}

Rate limits and usage

Base URL

https://api.thesentric.com

Write rate limit

1,000 requests per hour per API key

Read rate limit

Included in write limit

Burst protection

Enabled — sudden spikes are throttled

Authentication

Bearer API key in Authorization header

Permissions

reviews:write for POST • reviews:read for GET

Response format

JSON

Product ownership

Enforced — API key must own the product_id

Error reference

All errors return JSON with an error field and an appropriate HTTP status code.

400

Bad Request

Missing required fields or invalid values

401

Unauthorized

API key is missing, inactive, or invalid

403

Forbidden

API key lacks the required permission

404

Not Found

Product does not exist or you don't have access

429

Too Many Requests

Rate limit exceeded — check Retry-After header

500

Server Error

Something went wrong on our end — we're alerted automatically

403 — Permission error

{
  "error": "Insufficient API key permissions",
  "requiredPermission": "reviews:read"
}

429 — Rate limit

{
  "error": "Too many requests",
  "retryAfter": 60
}