Create a report

Adds a brand and starts its report over the last 3 months, the same as Add a brand in the app. Returns at once with status running; read the report until its status is ready.

Body

subjectstringrequired

The brand's name as people write it, for example Northpeak Outdoor.

keywordsstring[]

Words that find it. Defaults to the name and its hashtag and handle.

exclusionsstring[]

Words that leave a post out.

languagesstring[]

en, es, pt. Defaults to en.

range_days7 | 30 | 90

Days back. Defaults to 90.

Reports and limits. Creating a report through the API uses one report from your plan, the same as in the app. Requests are limited to 60 a minute per key. Responses include X-Reports-Left.

curl -X POST https://senti.now/api/v1/reports \
  -H "Authorization: Bearer $SENTI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject":"Northpeak Outdoor","exclusions":["Northpeak Realty"],"languages":["en","es"]}'

Response · 202

{
  "id": "3f6c2a1e-...",
  "brand_id": "9b1d4c77-...",
  "subject": "Northpeak Outdoor",
  "status": "running",
  "range": ["2026-07-20", "2026-10-18"]
}