X/Twitter Article Markdown API

X/Twitter Article Markdown API

Convert public X/Twitter article and tweet content into clean Markdown by tweet ID. X/Twitter Article Markdown API returns one dataset row per ID with tweet_id and md, ready for archives, AI workflows, documentation, and exports.

Extract Markdown from up to 10 public X/Twitter tweet IDs per run, then download the results from Apify as JSON, CSV, Excel, or HTML or call them from the API.

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

X/Twitter Article Markdown API (parsebird/x-twitter-article-markdown) converts public X/Twitter article or tweet content to Markdown. Call via ApifyClient: client.actor("parsebird/x-twitter-article-markdown").call(run_input={"tweetIds": ["2010751592346030461"]}). Inputs: tweetIds (array of strings, required, 1-10 tweet IDs or URLs containing tweet IDs). Output fields: tweet_id (string), md (Markdown string; empty when X does not expose the content publicly). API docs: https://docs.apify.com/api/v2. Get API token: https://console.apify.com/account#/integrations. Pricing: markdown-result event, $5.99 per 1,000 successful Markdown results on Free/Bronze/Silver and $2.99 per 1,000 on Gold.

What is X/Twitter Article Markdown API?

X/Twitter Article Markdown API is an X/Twitter article to Markdown converter for public content. Add one or more tweet IDs and the actor attempts to extract publicly available article or tweet text, normalize it into Markdown, and save it to an Apify dataset.

Use it as an X scraper API alternative when you need Markdown output for research notes, AI pipelines, content backup, or knowledge management. New Apify users can test it with the Apify free trial.

What can X/Twitter Article Markdown API do?

• Convert public X/Twitter article rich-text blocks to Markdown
• Process up to 10 tweet IDs in one run
• Keep output simple: tweet_id and md
• Export Markdown results as JSON, CSV, Excel, or HTML from the Apify dataset
• Access results through the Apify API
• Schedule recurring runs with Apify schedules
• Send results to apps and databases with Apify integrations

X can limit what is visible without authentication. X/Twitter Article Markdown API uses public tweet/article mirror data when available, then converts the article's rich-text blocks into Markdown. When a tweet ID is deleted, private, restricted, or unsupported by the public source, the actor returns the ID with an empty md value instead of fabricating content.

What data can you extract from X/Twitter?

Data Field	Type	Description
tweet_id	string	The X/Twitter tweet ID supplied in the input
md	string	Markdown content extracted from the public article or tweet payload

How to convert X/Twitter articles to Markdown

1. Open X/Twitter Article Markdown API on Apify.
2. Paste up to 10 tweet IDs into the Tweet IDs input field.
3. Click Start.
4. Open the dataset when the run finishes.
5. Download the Markdown rows as JSON, CSV, Excel, or HTML, or fetch them through the API.

Input parameters

Parameter	Type	Required	Default	Description
tweetIds	array	Yes	-	Up to 10 X/Twitter tweet IDs. URLs containing tweet IDs are also accepted.

Output example

[
  {
    "tweet_id": "2010751592346030461",
    "md": "# How to fix your entire life in 1 day\n\nIf you're anything like me, you think new years resolutions are stupid."
  },
  {
    "tweet_id": "2034246147318202855",
    "md": "# Example article title\n\nArticle text converted to Markdown."
  }
]

Download results in JSON, CSV, Excel, or HTML from the Apify dataset.

Programmatic API usage

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run_input = {
    "tweetIds": ["2010751592346030461"],
}

run = client.actor("parsebird/x-twitter-article-markdown").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["tweet_id"])
    print(item["md"])

JavaScript

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_API_TOKEN>" });

const input = {
    tweetIds: ["2010751592346030461"],
};

const run = await client.actor("parsebird/x-twitter-article-markdown").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

items.forEach((item) => {
    console.log(item.tweet_id);
    console.log(item.md);
});

Get your API token at Apify Console -> Integrations. Use Apify integrations to send Markdown results to Google Sheets, Make, Zapier, webhooks, or your own database.

Use cases

• Knowledge management: Save public X/Twitter long-form content to Markdown vaults
• AI workflows: Feed Markdown into summarizers, RAG pipelines, and agent tools
• Research archives: Keep stable text copies of public social content for analysis
• Publishing workflows: Convert public X/Twitter content into Markdown for CMS review

How does the X/Twitter Markdown extraction work?

1. The actor validates and deduplicates the tweetIds input.
2. It requests public FxTwitter tweet/article data for each tweet ID.
3. It reads article rich-text blocks, entity ranges, inline styles, links, dividers, and media references.
4. The actor converts the article structure into Markdown headings, lists, blockquotes, images, and paragraphs.
5. The actor pushes one dataset row per processed tweet ID.
6. Successful Markdown results are charged as markdown-result events.

How much does it cost to convert X/Twitter articles to Markdown?

X/Twitter Article Markdown API uses pay-per-event pricing. You are charged only for successful Markdown results, not for IDs that return an empty md.

Event	Free / Bronze / Silver	Gold
markdown-result	$5.99 / 1,000 results	$2.99 / 1,000 results

Example: 1,000 successful Markdown rows cost $5.99 on Free, Bronze, or Silver plans and $2.99 on Gold. Apify's free trial includes platform credits you can use to test the actor.

Is it legal to scrape X/Twitter articles?

Scraping public web data can be legal when done responsibly, but laws and platform terms vary by jurisdiction and use case. X/Twitter Article Markdown API is designed for publicly available content and does not bypass login-only access. Review X's terms, avoid collecting sensitive personal data, and read Apify's overview of web scraping legality before using scraped data commercially.

Other X/Twitter scrapers and related Actors

• Truth Social Scraper - scrape public Truth Social posts
• Truth Social Comment Scraper - extract public comment data
• YouTube Search Scraper - collect YouTube search results
• YouTube Thumbnail Downloader - download YouTube thumbnails
• Apify Store Social media Actors - browse more social media scraping tools

FAQ

Can this actor access private X/Twitter articles? No. It only attempts to extract content exposed through public X/Twitter surfaces.

Why is md empty for some tweet IDs? X may return no public text for deleted, private, restricted, login-gated, or unsupported article IDs. The actor keeps the row so you can see which ID did not return public Markdown.

Can I schedule recurring runs? Yes. Use Apify scheduling to run the actor daily, weekly, or at a custom interval.

Can I use this X/Twitter Markdown API from Python or JavaScript? Yes. Use the API examples above or the Apify API directly.

Where can I report extraction issues? Use the Actor's Issues tab on Apify and include a tweet ID that reproduces the problem.