# API Direct – Get Tweet by ID

> API Direct – Get Tweet by ID is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Fetches full details for a single tweet given its numeric tweet ID, with optional AI-powered sentiment/emotion analysis.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/twitter/tweet?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-get-tweet-by-id-a50f2d71
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P6r23QtpA-Njfe70A3Bxa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-direct-get-tweet-by-id-a50f2d71
```

Example prompt: Can you fetch the full details of the tweet with ID 1812345678901234567, and also include the sentiment and emotion breakdown for it?

## When to prefer this

Use this endpoint when you have a specific tweet ID and need full tweet details or emotional/sentiment analysis on that single tweet. Prefer this over the tweet search endpoint when you already know the exact tweet you need rather than searching by keyword. The optional AI sentiment layer makes it uniquely suited for content moderation, brand monitoring, or social research workflows that require emotional tone alongside raw tweet data.

## Known failure modes

- Invalid tweet ID format (non-numeric) returns validation error
- Tweet ID does not exist or has been deleted returns 404 or empty result
- Tweet is from a private/protected account and is not accessible
- Rate limiting or quota exceeded returns 429 error
- Malformed request missing required tweet_id parameter

## How this service works

Get detailed information for a single tweet by its ID.

## Output

Returns full tweet details including tweet text, author information, timestamps, engagement metrics (likes, retweets, replies), and optionally a sentiment object containing per-emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0–100), dominant emotion, emotional intensity (0–10), and polarity (positive, negative, or neutral).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "tweet_id"
     ],
     "properties": {
      "tweet_id": {
       "type": "string",
       "pattern": "^[0-9]+$",
       "description": "Numeric tweet ID"
      },
      "get_sentiment": {
       "type": "boolean",
       "default": false,
       "description": "Set to true to add AI emotion analysis to the tweet. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). If the twe"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-get-tweet-by-id-a50f2d71/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)