Quickstart

From zero to your first analyzed feedback in ten minutes.

Choose how feedback comes in

#

Everything you send lands in the same pipeline — redaction, sentiment, type, language, clustering — so start with whichever path is least work for you:

The rest of this page uses the REST API because it's the most explicit. Grab a secret key from Settings → API keys — it starts with sk_ and is shown once.

Send your first feedback

#

Verify the key, then post an item. You get a 202 back instantly — analysis runs asynchronously and is usually ready in 2–5 seconds.

1 · Verify your key
curl https://app.sentriment.com/api/v1/ping \
  -H "Authorization: Bearer sk_live_…"
2 · Submit feedback
curl -X POST https://app.sentriment.com/api/v1/feedback \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4231-note" \
  -d '{
    "text": "Checkout freezes when I apply a coupon",
    "userId": "usr_123",
    "email": "dana@acme.com",
    "metadata": { "plan": "pro", "page": "/checkout" }
  }'

Pass email now, thank yourself later

Sending email alongside userId lets Sentriment stitch this person together with their Intercom and Zendesk tickets automatically. See Identifying users.

Read the analysis

#

List your feedback back and you'll see each item enriched with sentiment, a type, emotions, detected language, and the cluster it was grouped into.

3 · Read it back
curl "https://app.sentriment.com/api/v1/feedback?limit=1" \
  -H "Authorization: Bearer sk_live_…"

# → sentiment, type, emotions, language, clusterId — per item

That's the whole loop. Open the dashboard and the item is already in the Feed, its theme forming in Clusters, and the user appearing under Users.

Where to go next

#
Was this page helpful?