# twit.sh X Article by Tweet ID

> twit.sh X Article by Tweet ID is a paid API for AI agents from twit.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches full X Article content and engagement metrics for a specific tweet ID, including article body, metadata, and public metrics.

## Facts

- Endpoint: GET https://twit.sh/articles/by/id
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twit-sh-x-article-by-tweet-id-4644181f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ReSzVtOWl53npEiRf3oFz

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 twit-sh-x-article-by-tweet-id-4644181f
```

Example prompt: Can you pull up the full content of the X Article posted in tweet ID 1110302988 — I want the title, article body, author, and how many likes and retweets it has?

## When to prefer this

Use this endpoint when you need the full body of an X Article (long-form post) by its tweet ID, including structured metadata and public engagement metrics, without needing a Twitter developer account or API key. Prefer this over the official Twitter API when you want frictionless, pay-per-request autonomous access for AI agents.

## Known failure modes

- Invalid or non-existent tweet ID returns an error or empty response
- Tweet ID exists but is not an X Article post (plain tweet, not long-form)
- Payment failure if USDC balance is insufficient on Base
- Rate limiting or temporary unavailability of X data
- Article may have been deleted or made private since indexing

## How this service works

Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.

## Output

Returns a JSON object containing the tweet ID, full article object (title, markdown body, preview text, cover image URL, published and modified timestamps), author details (ID, name, username), tweet creation date, and public engagement metrics (like count, retweet count, reply count, quote count).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Numeric tweet ID of the X Article post"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "1110302988",
   "text": "Running bitcoin",
   "author": {
    "id": "9253672",
    "name": "Hal Finney",
    "username": "halfin"
   },
   "article": {
    "id": "abc123",
    "title": "My X Article",
    "modified_at": "2025-01-02T00:00:00.000Z",
    "preview_text": "A short preview of the article content.",
    "published_at": "2025-01-01T00:00:00.000Z",
    "article_content": "# My X Article\n\nParagraph one.\n\nParagraph two with **bold** text.",
    "cover_image_url": "https://pbs.twimg.com/media/example.jpg"
   },
   "created_at": "2009-01-11T03:39:18.000Z",
   "public_metrics": {
    "like_count": 134000,
    "quote_count": 3500,
    "reply_count": 5400,
    "retweet_count": 32000
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twit-sh-x-article-by-tweet-id-4644181f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twit.sh](https://www.zero.xyz/host/twit.sh/llms.txt)