Analyze X/Twitter Post

curl -X POST "https://postsyncer.com/api/v1/posts/analyze-twitter" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://x.com/postsyncer/status/1234567890",
    "question": "What is the overall sentiment in the replies?"
  }'

{
  "401": {},
  "403": {},
  "422": {},
  "answer": "<string>",
  "tweet": {}
}

POST

posts

analyze-twitter

curl -X POST "https://postsyncer.com/api/v1/posts/analyze-twitter" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://x.com/postsyncer/status/1234567890",
    "question": "What is the overall sentiment in the replies?"
  }'

{
  "401": {},
  "403": {},
  "422": {},
  "answer": "<string>",
  "tweet": {}
}

This works on any public tweet URL - the post does not need to exist in your PostSyncer workspace.

Body

string

required

Full public X/Twitter status URL (e.g. https://x.com/username/status/1234567890 or https://twitter.com/username/status/1234567890).

string

required

Your question about the post and its replies (3–2000 characters). Examples: overall sentiment, common objections, feature requests, or whether people agree with the author.

curl -X POST "https://postsyncer.com/api/v1/posts/analyze-twitter" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://x.com/postsyncer/status/1234567890",
    "question": "What is the overall sentiment in the replies?"
  }'

Response

200 - JSON object:

string

AI-generated answer based on the post and fetched replies.

object

Normalized post metadata: id, url, text, author, created_at, and metrics (likes, replies, reposts, views, quotes, bookmarks).

{
  "answer": "Most replies are positive, with users praising the launch timeline...",
  "tweet": {
    "id": "1234567890",
    "url": "https://x.com/postsyncer/status/1234567890",
    "text": "We just shipped a new feature...",
    "author": "@postsyncer",
    "created_at": "2026-05-20T12:00:00.000Z",
    "metrics": {
      "likes": 120,
      "replies": 45,
      "reposts": 18,
      "views": 12000,
      "quotes": 3,
      "bookmarks": 9
    }
  }
}

Error Codes

Unauthorized

Missing or invalid API token

Forbidden

Token does not have the posts ability

Validation Error

Invalid URL, unsupported link, tweet could not be fetched, or AI could not generate an answer

MCP

The same action is available as the MCP tool analyze-twitter-post - see MCP tools reference.

Start here

Guides

MCP

API reference

Analyze X/Twitter Post