---
title: "Article Data"
method: POST
path: "/article"
tags: ["Tweets"]
---

# Article Data

`POST /article`

Returns full data for a Twitter/X Article (long-form post) by its URL. The response includes the complete article text, a short preview excerpt, cover image URL, publication date, engagement metrics, and the author's profile.

## Request body

- TweetsArticleReq
  - `tweet_link` string — Full URL of the tweet or article (e.g. `https://x.com/user/status/123`) or just the tweet ID.

## Response `200`

OK

- TweetsArticleRes
  - `author` CommonUser
    - `bio_urls` string[] — URLs found in the user's bio.
    - `can_dm` boolean — Whether the account accepts direct messages.
    - `created_at` string — Account creation date in ISO 8601 format.
    - `description` string — Profile bio text.
    - `display_name` string — User's display name.
    - `favourites_count` integer — Total number of tweets this user has liked.
    - `followers_count` integer — Number of accounts following this user.
    - `followings_count` integer — Number of accounts this user follows.
    - `id` string — Unique Twitter/X user ID.
    - `location` string — Location string from the user's profile.
    - `media_count` integer — Total number of media items posted by this user.
    - `pinned_tweet_ids` string[] — IDs of the user's pinned tweets.
    - `possibly_sensitive` boolean — Whether the account is flagged as possibly containing sensitive content.
    - `profile_background_image_url` string — URL of the user's profile background image.
    - `profile_image_url` string — URL of the user's avatar image.
    - `protected` boolean — Whether the account's tweets are protected (private).
    - `tweets_count` integer — Total number of tweets posted by this user.
    - `username` string — Current Twitter/X handle (without @).
    - `verified` boolean — Whether the account has a verified badge.
  - `bookmark_count` integer — Number of bookmarks.
  - `cover_image_url` string — URL of the article's cover image.
  - `full_text` string — Complete article text.
  - `likes_count` integer — Number of likes.
  - `preview_text` string — Short preview or excerpt of the article.
  - `published_at` string — Publication date in ISO 8601 format.
  - `quote_count` integer — Number of quote tweets.
  - `reply_count` integer — Number of replies.
  - `retweet_count` integer — Number of retweets.
  - `views_count` integer — Number of views (impressions).

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sorsa/apis/api-sorsa-io.md) · [All operations](https://skmtc.net/sorsa/apis/api-sorsa-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sorsa/api-sorsa-io/versions/7742c72d6966/schema)