Skip to main content
GET
Sentiment Time Series

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys.

Query Parameters

startDate
string<date>

Start date for sentiment data (YYYY-MM-DD). Max range 90 days.

endDate
string<date>

End date for sentiment data (YYYY-MM-DD). Max range 90 days.

range
enum<string>
default:day

Time grouping for the data (day, week, or month)

Available options:
day,
week,
month
models

Filter by LLM models. Repeat for multiple

promptTypes

Filter by prompt type. Repeat for multiple

Available options:
ORGANIC,
BRAND_SPECIFIC,
COMPETITOR_COMPARISON
promptId
string

Filter by specific prompt ID

llmMonitorId
string

Filter by specific LLM monitor ID

Response

Default Response

date
string<date>
required

Bucket date (YYYY-MM-DD)

value
number | null
required

Aggregated sentiment score for the bucket, or null if empty

Example: