Twitter sentiment analysis API for X posts with AI

{
  "results": [
    {
      "tweet": {
        "id": "1893456789012345678",
        "text": "The new headphones sound great. The app keeps crashing.",
        "retweetCount": 4,
        "replyCount": 2,
        "likeCount": 31
      },
      "analysis": {
        "status": "succeeded",
        "answers": [
          {
            "questionId": "sentiment",
            "questionVersion": "sentiment:2",
            "type": "choice",
            "value": "mixed",
            "confidence": 0.88
          }
        ],
        "questions": [
          {
            "id": "sentiment",
            "version": "sentiment:2"
          }
        ],
        "contextBytes": 612,
        "contextAvailability": {
          "quote": "not_applicable",
          "reply": "not_applicable",
          "author": "available",
          "media": "not_supplied",
          "article": "not_supplied"
        }
      },
      "answers": {
        "sentiment": "mixed",
        "intensity": 1,
        "sarcasm": 0.03
      },
      "sourceDomains": [],
      "cashtags": []
    }
  ],
  "unanalyzed": [
    {
      "id": "1893456789012345679",
      "status": "skipped",
      "reason": "post_unavailable"
    }
  ],
  "analysisSummary": {
    "schemaVersion": 1,
    "rows": {
      "analyzed": 1,
      "failed": 0,
      "skipped": 0
    },
    "engagement": 37,
    "questions": {
      "sentiment": {
        "type": "choice",
        "counts": {
          "positive": 0,
          "negative": 0,
          "mixed": 1,
          "neutral": 0,
          "unclear": 0
        },
        "shares": {
          "positive": 0,
          "negative": 0,
          "mixed": 1,
          "neutral": 0,
          "unclear": 0
        }
      }
    },
    "targets": []
  },
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_account_protected",
  "message": "Account is protected. Choose a public account."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

POST

analysis

sentiment

Twitter sentiment analysis API for X posts with AI

curl --request POST \
  --url https://xquik.com/api/v1/x/analysis/sentiment \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "tweetIds": [
    "<string>"
  ],
  "query": "<string>",
  "username": "<string>",
  "listId": "<string>",
  "quotesOf": "<string>",
  "repliesTo": "<string>",
  "sinceTime": "<string>",
  "untilTime": "<string>",
  "queryType": "<string>",
  "limit": 123,
  "cursor": "<string>",
  "texts": [
    "<string>"
  ],
  "baseline": [
    {}
  ],
  "analysis": {
    "targets": [
      {}
    ],
    "context": "<string>",
    "questions": [
      {}
    ],
    "preset": "<string>",
    "maxContextBytes": 123,
    "concurrency": 123
  }
}
'

import requests

url = "https://xquik.com/api/v1/x/analysis/sentiment"

payload = {
    "tweetIds": ["<string>"],
    "query": "<string>",
    "username": "<string>",
    "listId": "<string>",
    "quotesOf": "<string>",
    "repliesTo": "<string>",
    "sinceTime": "<string>",
    "untilTime": "<string>",
    "queryType": "<string>",
    "limit": 123,
    "cursor": "<string>",
    "texts": ["<string>"],
    "baseline": [{}],
    "analysis": {
        "targets": [{}],
        "context": "<string>",
        "questions": [{}],
        "preset": "<string>",
        "maxContextBytes": 123,
        "concurrency": 123
    }
}
headers = {"Content-Type": "<content-type>"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>'},
  body: JSON.stringify({
    tweetIds: ['<string>'],
    query: '<string>',
    username: '<string>',
    listId: '<string>',
    quotesOf: '<string>',
    repliesTo: '<string>',
    sinceTime: '<string>',
    untilTime: '<string>',
    queryType: '<string>',
    limit: 123,
    cursor: '<string>',
    texts: ['<string>'],
    baseline: [{}],
    analysis: {
      targets: [{}],
      context: '<string>',
      questions: [{}],
      preset: '<string>',
      maxContextBytes: 123,
      concurrency: 123
    }
  })
};

fetch('https://xquik.com/api/v1/x/analysis/sentiment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/analysis/sentiment"

	payload := strings.NewReader("{\n  \"tweetIds\": [\n    \"<string>\"\n  ],\n  \"query\": \"<string>\",\n  \"username\": \"<string>\",\n  \"listId\": \"<string>\",\n  \"quotesOf\": \"<string>\",\n  \"repliesTo\": \"<string>\",\n  \"sinceTime\": \"<string>\",\n  \"untilTime\": \"<string>\",\n  \"queryType\": \"<string>\",\n  \"limit\": 123,\n  \"cursor\": \"<string>\",\n  \"texts\": [\n    \"<string>\"\n  ],\n  \"baseline\": [\n    {}\n  ],\n  \"analysis\": {\n    \"targets\": [\n      {}\n    ],\n    \"context\": \"<string>\",\n    \"questions\": [\n      {}\n    ],\n    \"preset\": \"<string>\",\n    \"maxContextBytes\": 123,\n    \"concurrency\": 123\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "results": [
    {
      "tweet": {},
      "answers": {},
      "analysis": {},
      "sourceDomains": [
        "<string>"
      ],
      "cashtags": [
        "<string>"
      ],
      "monitor": {}
    }
  ],
  "unanalyzed": [
    {
      "id": "<string>",
      "status": "<string>",
      "reason": "<string>"
    }
  ],
  "analysisSummary": {
    "schemaVersion": 123,
    "rows": {},
    "engagement": 123,
    "questions": {},
    "targets": [
      {}
    ],
    "cashtags": [
      {}
    ],
    "sourceDomains": [
      {}
    ],
    "monitor": {}
  },
  "has_next_page": true,
  "next_cursor": "<string>"
}

2 credits per analyzed post · All plans from $0.00012/credit · Supports guest paid reads

Sentiment analysis reads each post with AI and answers 3 questions about it. The endpoint is POST /api/v1/x/analysis/sentiment.

Answer	Type	Values
`sentiment`	Choice	`positive`, `negative`, `mixed`, `neutral`, or `unclear`
`intensity`	Score	`0` no attitude, `1` measured, `2` emphatic
`sarcasm`	Probability	From `0` to `1`, the chance the wording means otherwise

curl -X POST https://xquik.com/api/v1/x/analysis/sentiment \
  -H "x-api-key: xq_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Sony WH-1000XM6 lang:en",
    "limit": 20,
    "analysis": { "targets": [{ "name": "Sony", "aliases": ["WH-1000XM6"] }] }
  }' | jq

const response = await fetch("https://xquik.com/api/v1/x/analysis/sentiment", {
  method: "POST",
  headers: {
    "x-api-key": "xq_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "Sony WH-1000XM6 lang:en",
    limit: 20,
    analysis: { targets: [{ name: "Sony", aliases: ["WH-1000XM6"] }] },
  }),
});
const data = await response.json();
if (!response.ok) throw new Error(`${data.error}: ${data.message}`);

const sentimentRows = data.results.map((result) => ({
  tweet_id: result.tweet.id,
  text: result.tweet.text,
  sentiment: result.answers.sentiment,
  intensity: result.answers.intensity,
  sarcasm: result.answers.sarcasm,
}));
const shares = data.analysisSummary.questions.sentiment.shares;
const retryIds = data.unanalyzed.filter((post) => post.status === "failed").map((post) => post.id);

process.stdout.write(`${JSON.stringify({ rows: sentimentRows.length, shares, retryIds })}\n`);

import json
import requests

response = requests.post(
    "https://xquik.com/api/v1/x/analysis/sentiment",
    headers={"x-api-key": "xq_your_api_key_here"},
    json={
        "query": "Sony WH-1000XM6 lang:en",
        "limit": 20,
        "analysis": {"targets": [{"name": "Sony", "aliases": ["WH-1000XM6"]}]},
    },
    timeout=120,
)
data = response.json()
if not response.ok:
    raise RuntimeError(f"{data['error']}: {data['message']}")

sentiment_rows = [
    {
        "tweet_id": result["tweet"]["id"],
        "text": result["tweet"]["text"],
        "sentiment": result["answers"]["sentiment"],
        "intensity": result["answers"]["intensity"],
        "sarcasm": result["answers"]["sarcasm"],
    }
    for result in data["results"]
]
shares = data["analysisSummary"]["questions"]["sentiment"]["shares"]
retry_ids = [post["id"] for post in data["unanalyzed"] if post["status"] == "failed"]
print(json.dumps({"rows": len(sentiment_rows), "shares": shares, "retry_ids": retry_ids}))

The snippets build 1 row per analyzed post and print the totals. They do not print the full response.

Pick the posts to analyze

Send tweetIds, texts, or a search, never more than 1. Sending none, or more than 1, returns 400 invalid_input.

Source	Send	Posts analyzed
Post IDs	`tweetIds`, up to 100 post IDs or post URLs	Each post once
Your own texts	`texts`, up to 100 strings	Each text. Reads nothing from X
A search	1 or more of the search fields below	Up to `limit` posts, 20 by default

A search combines every search field you send into 1 X search.

Search field	Posts it finds
`query`	An X search, with the operators of Search Tweets
`username`	1 account’s posts. A handle, `@handle`, or profile URL
`listId`	A public List’s posts. A List ID or URL
`quotesOf`	The quotes of 1 post. A post ID or URL
`repliesTo`	The replies in 1 post’s conversation. A post ID or URL
`sinceTime` & `untilTime`	Posts between 2 times. An ISO 8601 time or Unix seconds

queryType sets the order, Latest or Top. For more posts than 1 call returns, send the same search again with cursor set to next_cursor. Stop when has_next_page is false.

{
  "username": "NASA",
  "sinceTime": "2026-09-25T00:00:00Z",
  "untilTime": "2026-09-26T00:00:00Z"
}

Your own texts come back with the IDs text:1, text:2, and so on.

{
  "texts": ["We shipped dark mode today. Tell us what breaks."]
}

Read the sentiment answers

results[].answers holds each decision by question ID. Store it beside the post.

`sentiment`	Meaning
`positive`	Praise, satisfaction, excitement, or support
`negative`	Criticism, frustration, disappointment, or hostility
`mixed`	Both positive and negative judgments
`neutral`	Information, listings, deals, or questions without a verdict
`unclear`	The subject or attitude cannot be established

Upbeat deals, ads, and giveaways that state no opinion count as neutral. intensity judges wording, emphasis, and emoji, not engagement counts. It can have decimals, such as 1.4 between measured and emphatic. sarcasm is high when the literal wording contradicts the intended attitude. results[].analysis.answers adds the confidence of each answer and the probability of each category or level. Use it to set your own thresholds.

Judge the attitude toward a brand

Name the brand, person, or product in analysis.targets, with its aliases. The AI then judges the attitude toward that target. Without targets, it judges the attitude toward the post’s main subject. analysisSummary.targets counts each target’s mentions and sentiment categories. It also lists the most engaged posts per category.

Track sentiment over time

analysisSummary.questions.sentiment counts posts per category. shares holds each category’s share of posts, and engagementShares its share of engagement. Store both per run to chart a trend. To read 1 day, send sinceTime and untilTime with the search. Send username to follow 1 account’s posts.

Compare with an earlier answer

Send the results of an earlier call as baseline to see what changed. Each row in the new results gets monitor, and analysisSummary.monitor counts the posts per status. The comparison costs nothing extra.

{
  "query": "Sony WH-1000XM6 lang:en",
  "baseline": [
    { "id": "1893456789012345678", "answers": { "sentiment": "positive", "intensity": 1.2 } }
  ]
}

A baseline row needs the post’s id, or tweet.id, and its answers. Send whole result rows when you have them. Their monitor carries the settings’ fingerprint, so rows from other settings show as not_comparable.

`monitor.status`	Meaning
`first_run`	You sent no baseline
`new_to_baseline`	The baseline has no row for this post
`unchanged`	Every decision matches the baseline
`changed`	At least 1 decision clearly moved. `changes` lists each 1
`not_comparable`	Other settings made the row, or it answers none of these questions

A decision counts as changed only when the new answer clearly leaves the old one, so near ties between calls stay unchanged. Keep analysis the same between calls for comparable answers.

Budget the analysis

Each analyzed post costs 2 credits. Each text in texts costs the same. Posts in unanalyzed cost nothing. When credits cover fewer posts than you asked for, fewer come back. The posts left over appear in unanalyzed with insufficient_credits. If credits cover no post, the call returns 402 insufficient_credits.

`unanalyzed[].reason`	Meaning	What to do
`post_unavailable`	X returns no such post	Skip the post
`missing_text`	The post has no text	Skip the post
`insufficient_credits`	Credits ran out	Add credits, then send it again
`context_limit`	The settings leave the post no room	Shorten the context or questions
Any other reason	The analysis failed (`status: "failed"`)	Send the post again

Ask your own questions

Send analysis.questions to ask up to 8 questions of your own. They replace the 3 sentiment questions, and the price stays the same. A choice picks 1 category, a score picks 1 level, and a probability answers yes or no. Write question IDs and category names in lower case without hyphens, such as feature_request.

Body

string[]

Up to 100 post IDs or post URLs, such as x.com/nasa/status/20. A post named twice is analyzed once. Send tweetIds, texts, or a search, not more than 1.

string

X search to analyze, with the operators of Search Tweets.

string

Analyze 1 account’s posts. Send a handle, with or without @, or a profile URL.

string

Analyze a public List’s posts. Send its ID or URL.

string

Analyze the quotes of 1 post. Send its ID or URL.

string

Analyze the replies in 1 post’s conversation. Send its ID or URL.

string

Inclusive start of the search, such as 2026-09-25T00:00:00Z. Unix seconds also work. A time without an offset is UTC.

string

Exclusive end of the search. Unix seconds also work. A time without an offset is UTC.

string

Search order: Latest or Top. Defaults to Latest.

integer

Maximum posts to analyze from the search. Range: 1-100. Defaults to 20. Credits can return fewer.

string

The next_cursor of the page before. Send the same search with it.

string[]

Up to 100 texts of your own, such as drafts. Each must contain words. Reads nothing from X.

object[]

Rows of an earlier answer to compare with, up to 10,000, such as its results. Each needs the post’s id, or tweet.id, and its answers. Each new result’s monitor says whether the post is new, changed, or unchanged. The comparison costs nothing extra.

object

Optional settings. Leave it out to ask the route’s own questions.

Show Analysis fields

object[]

Up to 100 brands, people, assets, or topics the questions are about. Each has a name and optional aliases, such as a ticker or product name.

string

Background the AI reads with every post, such as your product or market.

object[]

1 to 8 questions of your own, which replace the route’s questions. Each needs an id, a type of choice, score, or probability, a version, and instructions. A choice adds categories, a score adds levels, and a probability can add criteria.

string

A ready set of questions, used when questions is left out: brand, complaints, competitors, purchase_intent, product_feedback, news, sentiment, or market. complaints, competitors, purchase_intent, and product_feedback need targets.

integer

Bytes of post, quote, and settings the AI reads. Range: 1-64000. Defaults to 64000. Xquik cuts a longer post to fit.

integer

Posts analyzed at the same time. Range: 1-16. Defaults to 16.

Headers

string

Full account API key. An OAuth bearer token also works.

string

Send Bearer xq_your_guest_key_here for an active paid_reads guest key.

string

required

Must be application/json. The body can be up to 256 KB.

Response

200 OK

object[]

Each analyzed post with its answers. Each row costs 2 credits.

Show Result fields

object

The post, as Search Tweets returns it. Your own texts have the IDs text:1, text:2, and so on.

object

Each decision by question ID. sentiment is a category, intensity a level from 0, and sarcasm a probability from 0 to 1.

object

The answers in full. status is succeeded. answers gives each answer’s value, confidence, and probabilities, or a probability. questions names the ID and version of each question. contextBytes and contextAvailability say what the AI read beside the post’s text.

string[]

Hostnames the post links to, without t.co.

string[]

Cashtags in the post’s text, in upper case.

object

The comparison with baseline: status, changedQuestionIds, changes with each previous and current decision, and the settings’ configurationFingerprint.

object[]

Each post without an analysis. These cost nothing.

Show Unanalyzed fields

string

Post ID, or text:1 and so on for your own texts.

string

skipped or failed.

string

post_unavailable, missing_text, insufficient_credits, or context_limit. Any other reason means the analysis failed. Send the post again.

object

Totals of the answers across the analyzed posts.

Show Summary fields

integer

Version of the summary’s shape.

object

Posts by outcome: analyzed, failed, and skipped.

integer

Likes, reposts, replies, and quotes of the analyzed posts.

object

Totals by question ID. sentiment has counts, shares, engagementShares, and top posts per category. intensity has mean, engagementWeightedMean, and levels. sarcasm has mean, yes, and no.

object[]

Per target in analysis.targets: name, mentions, share, engagement, choices, and top posts.

object[]

Posts and category counts per cashtag, most posts first, up to 20.

object[]

Posts per linked hostname, most posts first, up to 20.

object

Posts per monitor.status in statuses, and up to 50 changed posts in changedRows.

boolean

Whether the search has more posts. Always false for tweetIds and texts.

string

Send it as cursor with the same search for the next page. Empty when there is none.

{
  "results": [
    {
      "tweet": {
        "id": "1893456789012345678",
        "text": "The new headphones sound great. The app keeps crashing.",
        "likeCount": 31,
        "retweetCount": 4,
        "replyCount": 2
      },
      "analysis": {
        "status": "succeeded",
        "answers": [
          {
            "questionId": "sentiment",
            "questionVersion": "sentiment:2",
            "type": "choice",
            "value": "mixed",
            "confidence": 0.88,
            "probabilities": {
              "positive": 0.06,
              "negative": 0.04,
              "mixed": 0.88,
              "neutral": 0.01,
              "unclear": 0.01
            }
          },
          {
            "questionId": "intensity",
            "questionVersion": "sentiment:2",
            "type": "score",
            "value": 1,
            "confidence": 0.81
          },
          {
            "questionId": "sarcasm",
            "questionVersion": "sentiment:2",
            "type": "probability",
            "probability": 0.03
          }
        ]
      },
      "answers": { "sentiment": "mixed", "intensity": 1, "sarcasm": 0.03 },
      "sourceDomains": [],
      "cashtags": []
    }
  ],
  "unanalyzed": [
    { "id": "1893456789012345679", "status": "skipped", "reason": "post_unavailable" }
  ],
  "analysisSummary": {
    "schemaVersion": 1,
    "rows": { "analyzed": 1, "failed": 0, "skipped": 0 },
    "engagement": 37,
    "questions": {
      "sentiment": {
        "type": "choice",
        "counts": { "positive": 0, "negative": 0, "mixed": 1, "neutral": 0, "unclear": 0 },
        "shares": { "positive": 0, "negative": 0, "mixed": 1, "neutral": 0, "unclear": 0 }
      }
    },
    "targets": [],
    "cashtags": [],
    "sourceDomains": []
  },
  "has_next_page": false,
  "next_cursor": ""
}

400 Invalid input

{
  "error": "invalid_input",
  "message": "Send only 1 of tweetIds, texts & a search such as query or username."
}

The body names no posts, names more than 1 source, or has an invalid field. The message says what to send instead. The request costs nothing.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

{ "error": "unauthenticated" }

Missing or invalid API key. Check the x-api-key header value.

402 Payment required

Full account keys can receive no_subscription, subscription_inactive, no_credits, or insufficient_credits with account payment options. Guest keys receive only the guest top-up action. The failed request creates no checkout. Ask the user to confirm before calling any checkout or top-up route.

403 Protected account

{ "error": "x_account_protected" }

A search that needs a protected author returns this. Choose a public account. The request costs nothing.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

503 Service busy

{ "error": "x_api_unavailable" }

Xquik is busy. Wait for the Retry-After header, then send the request again. The request costs nothing.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Twitter sentiment analysis API questions

How do I analyze the sentiment of tweets?

Send a search in query, or post IDs in tweetIds, to this endpoint. Each row in results holds the post and its sentiment, intensity, and sarcasm answers.

Can I measure the sentiment toward my brand?

Yes. Name the brand in analysis.targets, with its product names as aliases. The AI judges the attitude toward the brand, and analysisSummary.targets counts its mentions.

Does it detect sarcasm?

Yes. sarcasm is the probability, from 0 to 1, that the literal wording contradicts the intended attitude. Read it beside sentiment before you act on a post.

Can I check a draft before I post it?

Yes. Send the draft in texts. Xquik reads nothing from X, and each text costs 2 credits.

How much does sentiment analysis cost?

Each analyzed post costs 2 credits. Posts in unanalyzed and refused requests cost nothing.

Does this replace X’s official API?

No. This page documents Xquik, an independent third-party service. It does not document X’s official API.

Next steps. Market signals reads stock and crypto stances, or Search Tweets previews the posts a query returns.

{
  "results": [
    {
      "tweet": {
        "id": "1893456789012345678",
        "text": "The new headphones sound great. The app keeps crashing.",
        "retweetCount": 4,
        "replyCount": 2,
        "likeCount": 31
      },
      "analysis": {
        "status": "succeeded",
        "answers": [
          {
            "questionId": "sentiment",
            "questionVersion": "sentiment:2",
            "type": "choice",
            "value": "mixed",
            "confidence": 0.88
          }
        ],
        "questions": [
          {
            "id": "sentiment",
            "version": "sentiment:2"
          }
        ],
        "contextBytes": 612,
        "contextAvailability": {
          "quote": "not_applicable",
          "reply": "not_applicable",
          "author": "available",
          "media": "not_supplied",
          "article": "not_supplied"
        }
      },
      "answers": {
        "sentiment": "mixed",
        "intensity": 1,
        "sarcasm": 0.03
      },
      "sourceDomains": [],
      "cashtags": []
    }
  ],
  "unanalyzed": [
    {
      "id": "1893456789012345679",
      "status": "skipped",
      "reason": "post_unavailable"
    }
  ],
  "analysisSummary": {
    "schemaVersion": 1,
    "rows": {
      "analyzed": 1,
      "failed": 0,
      "skipped": 0
    },
    "engagement": 37,
    "questions": {
      "sentiment": {
        "type": "choice",
        "counts": {
          "positive": 0,
          "negative": 0,
          "mixed": 1,
          "neutral": 0,
          "unclear": 0
        },
        "shares": {
          "positive": 0,
          "negative": 0,
          "mixed": 1,
          "neutral": 0,
          "unclear": 0
        }
      }
    },
    "targets": []
  },
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_account_protected",
  "message": "Account is protected. Choose a public account."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Twitter sentiment analysis API for X posts with AI

curl --request POST \
  --url https://xquik.com/api/v1/x/analysis/sentiment \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "tweetIds": [
    "<string>"
  ],
  "query": "<string>",
  "username": "<string>",
  "listId": "<string>",
  "quotesOf": "<string>",
  "repliesTo": "<string>",
  "sinceTime": "<string>",
  "untilTime": "<string>",
  "queryType": "<string>",
  "limit": 123,
  "cursor": "<string>",
  "texts": [
    "<string>"
  ],
  "baseline": [
    {}
  ],
  "analysis": {
    "targets": [
      {}
    ],
    "context": "<string>",
    "questions": [
      {}
    ],
    "preset": "<string>",
    "maxContextBytes": 123,
    "concurrency": 123
  }
}
'

import requests

url = "https://xquik.com/api/v1/x/analysis/sentiment"

payload = {
    "tweetIds": ["<string>"],
    "query": "<string>",
    "username": "<string>",
    "listId": "<string>",
    "quotesOf": "<string>",
    "repliesTo": "<string>",
    "sinceTime": "<string>",
    "untilTime": "<string>",
    "queryType": "<string>",
    "limit": 123,
    "cursor": "<string>",
    "texts": ["<string>"],
    "baseline": [{}],
    "analysis": {
        "targets": [{}],
        "context": "<string>",
        "questions": [{}],
        "preset": "<string>",
        "maxContextBytes": 123,
        "concurrency": 123
    }
}
headers = {"Content-Type": "<content-type>"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>'},
  body: JSON.stringify({
    tweetIds: ['<string>'],
    query: '<string>',
    username: '<string>',
    listId: '<string>',
    quotesOf: '<string>',
    repliesTo: '<string>',
    sinceTime: '<string>',
    untilTime: '<string>',
    queryType: '<string>',
    limit: 123,
    cursor: '<string>',
    texts: ['<string>'],
    baseline: [{}],
    analysis: {
      targets: [{}],
      context: '<string>',
      questions: [{}],
      preset: '<string>',
      maxContextBytes: 123,
      concurrency: 123
    }
  })
};

fetch('https://xquik.com/api/v1/x/analysis/sentiment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/analysis/sentiment"

	payload := strings.NewReader("{\n  \"tweetIds\": [\n    \"<string>\"\n  ],\n  \"query\": \"<string>\",\n  \"username\": \"<string>\",\n  \"listId\": \"<string>\",\n  \"quotesOf\": \"<string>\",\n  \"repliesTo\": \"<string>\",\n  \"sinceTime\": \"<string>\",\n  \"untilTime\": \"<string>\",\n  \"queryType\": \"<string>\",\n  \"limit\": 123,\n  \"cursor\": \"<string>\",\n  \"texts\": [\n    \"<string>\"\n  ],\n  \"baseline\": [\n    {}\n  ],\n  \"analysis\": {\n    \"targets\": [\n      {}\n    ],\n    \"context\": \"<string>\",\n    \"questions\": [\n      {}\n    ],\n    \"preset\": \"<string>\",\n    \"maxContextBytes\": 123,\n    \"concurrency\": 123\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "results": [
    {
      "tweet": {},
      "answers": {},
      "analysis": {},
      "sourceDomains": [
        "<string>"
      ],
      "cashtags": [
        "<string>"
      ],
      "monitor": {}
    }
  ],
  "unanalyzed": [
    {
      "id": "<string>",
      "status": "<string>",
      "reason": "<string>"
    }
  ],
  "analysisSummary": {
    "schemaVersion": 123,
    "rows": {},
    "engagement": 123,
    "questions": {},
    "targets": [
      {}
    ],
    "cashtags": [
      {}
    ],
    "sourceDomains": [
      {}
    ],
    "monitor": {}
  },
  "has_next_page": true,
  "next_cursor": "<string>"
}

​Pick the posts to analyze

​Read the sentiment answers

​Judge the attitude toward a brand

​Track sentiment over time

​Compare with an earlier answer

​Budget the analysis

​Ask your own questions

​Body

​Headers

​Response

​200 OK

​400 Invalid input

​401 Unauthenticated

​402 Payment required

​403 Protected account

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​Twitter sentiment analysis API questions

​How do I analyze the sentiment of tweets?

​Can I measure the sentiment toward my brand?

​Does it detect sarcasm?

​Can I check a draft before I post it?

​How much does sentiment analysis cost?

​Does this replace X’s official API?

Pick the posts to analyze

Read the sentiment answers

Judge the attitude toward a brand

Track sentiment over time

Compare with an earlier answer

Budget the analysis

Ask your own questions

Body

Headers

Response

200 OK

400 Invalid input

401 Unauthenticated

402 Payment required

403 Protected account

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Twitter sentiment analysis API questions

How do I analyze the sentiment of tweets?

Can I measure the sentiment toward my brand?

Does it detect sarcasm?

Can I check a draft before I post it?

How much does sentiment analysis cost?

Does this replace X’s official API?