> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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).



## OpenAPI

````yaml /api-rest/openapi/openapi_structured_data.json post /v1/entity-sentiment/
openapi: 3.1.0
info:
  title: Bigdata Structured Data API
  description: Bigdata API documentation
  version: 1.0.0
servers:
  - url: https://api.bigdata.com/
security:
  - ApiKeyAuth: []
tags:
  - name: Market Data
    description: >-
      Market data endpoints including intraday prices, daily prices, price
      changes, and real-time quotes
  - name: Analyst Estimates
    description: >-
      Analyst estimates and ratings including analyst ratings, estimates, target
      prices, and earnings surprises
  - name: Financials & Ratios
    description: >-
      Financial statements and ratios including balance sheet, income statement,
      cash flow statement, key metrics TTM, and company ratios TTM
  - name: Company & Events
    description: >-
      Company information and events including company profile and events
      calendar
  - name: Fund Holdings
    description: >-
      Institutional fund holdings from SEC 13F filings including fund holdings
      and stock fund holdings
  - name: Knowledge Graph
    description: Corporate ownership and hierarchy data.
paths:
  /v1/entity-sentiment/:
    post:
      tags:
        - Market Data
      summary: Entity Sentiment
      description: >-
        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).
      operationId: query_entity_sentiment_v1_entity_sentiment__post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TimeSeriesSentimentQuery'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimeSeriesSentimentResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
components:
  schemas:
    TimeSeriesSentimentQuery:
      properties:
        identifier:
          $ref: '#/components/schemas/Identifier'
          description: >-
            Object specifying which identifier you are using to request the
            sentiment data. You must supply one type and its corresponding value
            or a list of entities.
        timestamp:
          $ref: '#/components/schemas/QueryDateRange'
          description: >-
            The time range for retrieving sentiment data. The expected date
            format is 'YYYY-MM-DD', for example, '2025-09-02'.
      type: object
      required:
        - identifier
        - timestamp
      title: TimeSeriesSentimentQuery
      description: Query model for time series sentiment request.
      example:
        identifier:
          type: rp_entity_id
          value: 4A6F00
        timestamp:
          start: '2025-01-01'
          end: '2025-01-20'
    TimeSeriesSentimentResponse:
      properties:
        results:
          $ref: '#/components/schemas/TimeSeriesSentimentResults'
          description: Sentiment time series results
        errors:
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
          title: Errors
          description: List of errors encountered while fetching data.
        metadata:
          $ref: '#/components/schemas/Metadata'
          description: Request metadata including request ID and timestamp.
      type: object
      required:
        - results
        - metadata
      title: TimeSeriesSentimentResponse
      description: Public API response for time series sentiment query.
    BadRequestError:
      properties:
        statusCode:
          type: integer
          const: 400
          title: Statuscode
          default: 400
        message:
          type: string
          title: Message
      type: object
      required:
        - message
      title: BadRequestError
      description: Bad Request Error
      example:
        message: Bad Request Error
        statusCode: 400
    TooManyRequestsError:
      properties:
        statusCode:
          type: integer
          const: 429
          title: Statuscode
          default: 429
        message:
          type: string
          title: Message
      type: object
      required:
        - message
      title: TooManyRequestsError
      description: Too many requests. Please try again later.
      example:
        message: Too many requests. Please try again later.
        statusCode: 429
    InternalServerError:
      properties:
        statusCode:
          type: integer
          const: 500
          title: Statuscode
          default: 500
        message:
          type: string
          title: Message
      type: object
      required:
        - message
      title: InternalServerError
      description: Internal Server Error
      example:
        message: Internal Server Error
        statusCode: 500
    Identifier:
      properties:
        type:
          $ref: '#/components/schemas/IdentifierType'
          description: >-
            The identifier namespace. Currently only `rp_entity_id` is
            supported.
          default: rp_entity_id
          examples:
            - rp_entity_id
        value:
          anyOf:
            - type: string
            - items:
                type: string
              type: array
          title: Value
          description: >-
            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`)
          examples:
            - 4A6F00
      type: object
      required:
        - type
        - value
      title: Identifier
    QueryDateRange:
      properties:
        start:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Start
          description: >-
            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'
          examples:
            - '2025-01-01'
        end:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: End
          description: >-
            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'.
          examples:
            - '2025-01-20'
      type: object
      title: QueryDateRange
    TimeSeriesSentimentResults:
      properties:
        name:
          type: string
          title: Name
          description: Company name
          examples:
            - Alphabet Inc.
        id:
          type: string
          title: Id
          description: RP entity identifier
          examples:
            - 4A6F00
        values:
          items:
            $ref: '#/components/schemas/SentimentDataPoint'
          type: array
          title: Values
          description: List of sentiment data points
          examples:
            - - date: '2025-10-20'
                daily_sentiment: 0.017404
                sentiment_pressure: 0.217784
                abnormal_media_attention: -0.833533
              - date: '2025-10-21'
                daily_sentiment: 0.033251
                sentiment_pressure: 0.208085
                abnormal_media_attention: -0.835593
      type: object
      required:
        - name
        - id
        - values
      title: TimeSeriesSentimentResults
      description: Results container for time series sentiment data.
    ErrorDetail:
      properties:
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
      type: object
      title: ErrorDetail
    Metadata:
      properties:
        request_id:
          type: string
          title: Request Id
        timestamp:
          type: string
          title: Timestamp
      type: object
      required:
        - request_id
      title: Metadata
    IdentifierType:
      type: string
      enum:
        - rp_entity_id
      title: IdentifierType
      default: rp_entity_id
    SentimentDataPoint:
      properties:
        date:
          type: string
          title: Date
          description: Date in YYYY-MM-DD format
          examples:
            - '2025-10-20'
        daily_sentiment:
          anyOf:
            - type: number
            - type: 'null'
          title: Daily Sentiment
          description: Mean event sentiment score
          examples:
            - 0.017404
        sentiment_pressure:
          anyOf:
            - type: number
            - type: 'null'
          title: Sentiment Pressure
          description: Abnormal sentiment indicator
          examples:
            - 0.217784
        abnormal_media_attention:
          anyOf:
            - type: number
            - type: 'null'
          title: Abnormal Media Attention
          description: Abnormal media volume indicator
          examples:
            - -0.833533
      type: object
      required:
        - date
      title: SentimentDataPoint
      description: Individual sentiment data for a specific date.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````