Developer · API reference

Sentiment

The tone of how AI answers talk about your brand.

Sentiment classifies the language AI models use around your brand as positive, neutral or negative. These endpoints return the sentiment score series and the company/source/provider leaderboards.

POST /analytics/sentiment-metrics

Get Sentiment Metrics

Get sentiment time series metrics for chart display

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· SentimentQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`group_by`	string[] \| null	No	—
`filters`	object	No	—
`min_datapoints`	integer \| null	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/sentiment-metrics" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Returns a JSON object on success.

POST /analytics/sentiment-combined

Get Combined Sentiment Metrics

Get combined sentiment metrics: top 10 leaderboard + top 7 chart history in one query

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· SentimentQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`group_by`	string[] \| null	No	—
`filters`	object	No	—
`min_datapoints`	integer \| null	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/sentiment-combined" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Field	Type	Notes
`success`	boolean	—
`message`	string	—
`conversationId`	string \| null	—
`data`	object \| null	—

POST /analytics/sentiment-company-leaderboard

Get Sentiment Company Leaderboard

Get sentiment company leaderboard

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· SentimentQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`group_by`	string[] \| null	No	—
`filters`	object	No	—
`min_datapoints`	integer \| null	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/sentiment-company-leaderboard" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Returns a JSON object on success.

POST /analytics/sentiment-source-leaderboard

Get Sentiment Source Leaderboard

Get sentiment source leaderboard

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· SentimentQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`group_by`	string[] \| null	No	—
`filters`	object	No	—
`min_datapoints`	integer \| null	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/sentiment-source-leaderboard" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Returns a JSON object on success.

POST /analytics/sentiment-provider-performance

Get Sentiment Provider Performance

Get sentiment metrics by AI provider

🔒 Requires Authorization: Bearer ll_… (or X-API-Key).

Request body· SentimentQuery

Field	Type	Required	Description
`company_id`	string	Yes	—
`date_range`	any[]	Yes	—
`time_granularity`	string	No	—
`include_change`	boolean	No	—
`limit`	integer \| null	No	—
`rolling_days`	integer \| null	No	—
`comparison_days`	integer \| null	No	—
`entity_type`	string \| null	No	—
`entity_id`	string \| null	No	—
`group_by`	string[] \| null	No	—
`filters`	object	No	—
`min_datapoints`	integer \| null	No	—

Example request

curl -X POST "https://api.lunalift.ai/analytics/sentiment-provider-performance" \
  -H "Authorization: Bearer ll_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "company_id": "string",
  "date_range": []
}'

Response · 200 OK

Returns a JSON object on success.