get/ai/sentiment-analysis

Sentiment Analysis

API Reference & Playground Get started for free

Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access X data through agntdata: Sentiment Analysis. Analyze text to determine if the emotional tone of the message is positive, negative, or neutral. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need tweets, user profiles, followers, search, and hashtag streams programmatically.

Use cases

AI agents that need X data in structured form

Analytics and monitoring pipelines for X content

Research and GTM workflows that combine X signals with other data

Parameters

Name	In	Type	Required	Description
text	query	string	required	—Default: `You can not be a platform that allows almost every opinion to be aired and lose traffic. People want to share their opinion on platforms they know freedom of speech exists to a very large extent. I get 99% of my news here on X, which is like days ahead of traditional media.`

Responses

200

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    },
    "hash": {
      "type": "string"
    },
    "trace_id": {
      "type": "string"
    },
    "sentiment": {
      "type": "object",
      "properties": {
        "value": {
          "type": "string"
        },
        "confidence": {
          "type": "number"
        }
      }
    },
    "elapsed_time": {
      "type": "number"
    }
  }
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "Sentiment_Analysis_get__ai_sentiment_analysis",
  "method": "get",
  "path": "/ai/sentiment-analysis",
  "summary": "Sentiment Analysis",
  "description": "Analyze text to determine if the emotional tone of the message is positive, negative, or neutral.",
  "parameters": [
    {
      "name": "text",
      "in": "query",
      "required": true,
      "schema": {
        "type": "string",
        "default": "You can not be a platform that allows almost every opinion to be aired and lose traffic. People want to share their opinion on platforms they know freedom of speech exists to a very large extent. I get 99% of my news here on X, which is like days ahead of traditional media."
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "200",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string"
              },
              "hash": {
                "type": "string"
              },
              "trace_id": {
                "type": "string"
              },
              "sentiment": {
                "type": "object",
                "properties": {
                  "value": {
                    "type": "string"
                  },
                  "confidence": {
                    "type": "number"
                  }
                }
              },
              "elapsed_time": {
                "type": "number"
              }
            }
          },
          "example": {
            "text": "You can not be a platform that allows almost every opinion to be aired and lose traffic. People want to share their opinion on platforms they know freedom of speech exists to a very large extent. I get 99% of my news here on X, which is like days ahead of traditional media.",
            "hash": "2d252f081fb05785cee399e372664a2687a2c1fdfe71b4c64806a30175b9672d",
            "trace_id": "2d8f5178-b848-4623-b1de-d8ec904e58f1",
            "sentiment": {
              "value": "POSITIVE",
              "confidence": 0.7711061835289001
            },
            "elapsed_time": 0.17128494009375572
          }
        }
      }
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Start for free

Related endpoints

postTranslate

/translate

getAvailable Locations (Beta)

/trends/available

getGet trends near a location (Beta)

/trends/

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

Get started for free View all endpoints

X APIX data APIsentiment analysis APIAI agents data APIX APIX data APIX for AI agents

Back to X (Twitter)