---
title: "Entity Sentiment"
method: POST
path: "/v1/entity-sentiment/"
tags: ["Market Data"]
---

# Entity Sentiment

`POST /v1/entity-sentiment/`

Returns a time series of daily sentiment metrics for a single entity over a specified date range. Sentiment is a quantified signal derived from unstructured text using rule-based and machine-learning methods, indicating likely positive or negative market impact. The response includes daily_sentiment (mean sentiment), sentiment_pressure (abnormal sentiment intensity), and abnormal_media_attention (abnormal media volume).

## Request body

- TimeSeriesSentimentQuery — Query model for time series sentiment request.
  - `identifier` Identifier, required
    - `type` 'rp_entity_id', required
    - `value` union, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)
      - string
      - string[]
  - `timestamp` QueryDateRange, required
    - `start` string, date, nullable — The start date of the time range for retrieving daily prices. Only prices occurring on or after this date will be included. The expected date format is 'YYYY-MM-DD', for example, '2025-09-02'
    - `end` string, date, nullable — The end date of the time range for retrieving daily prices. Only prices occurring on or before this date will be included. The expected date format is 'YYYY-MM-DD', for example, '2025-09-03'.

## Response `200`

Successful Response

- TimeSeriesSentimentResponse — Public API response for time series sentiment query.
  - `results` TimeSeriesSentimentResults, required — Results container for time series sentiment data.
    - `name` string, required — Company name
    - `id` string, required — RP entity identifier
    - `values` SentimentDataPoint[], required — List of sentiment data points
      - `date` string, required — Date in YYYY-MM-DD format
      - `daily_sentiment` number, nullable — The daily mean event sentiment represents the weighted average sentiment of all events detected on the same day for a given entity. Each event's sentiment is weighted by its relevance and novelty using a quadratic function. The sentiment score ranges from -1 (negative sentiment) to 1 (positive sentiment). This sentiment is enhanced by considering the entity sentiment from documents without events. Sentiment from subsidiaries is also added at parent level. Use-case: Captures the overall tone of news and events for a company on a given day, ranging from very negative to very positive.
      - `sentiment_pressure` number, nullable — The Z-score of the 90-days moving average of the daily sentiment normalized to [-1,1] using a sigmoid function. Absolute values over 0.9 can be considered abnormal, which approximately matches 3 standard deviations. A year is considered for z-standardization. Use-case: Measures how sentiment over the last 90 days compares to recent history, highlighting unusually strong positive or negative sentiment trends.
      - `abnormal_media_attention` number, nullable — The Z-score of the daily volume of media events for a company normalized to [-1,1] using a sigmoid function, indicating abnormal media attention. Absolute values over 0.9 can be considered abnormal, which approximately matches 3 standard deviations. Use-case: Indicates whether a company is receiving more or less media attention than usual, based on recent trends.
  - `errors` ErrorDetail[] — List of errors encountered while fetching data.
    - `message` string, nullable
  - `metadata` Metadata, required
    - `request_id` string, required
    - `timestamp` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)