POST /v1/data/twitter/articles/run
Pricing: $0.0045 per article ($4.50 per 1,000).
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Example
curl -X POST "https://api.mindcase.co/v1/data/twitter/articles/run?wait=true" \
-H "Authorization: Bearer $MINDCASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"params": {
"urls": [
"https://x.com/github/status/2082201573976056245",
"https://twitter.com/karpathy/status/2002118205729562949",
"https://x.com/thedankoe/status/2010751592346030461"
]
}
}'
import os, requests
r = requests.post(
"https://api.mindcase.co/v1/data/twitter/articles/run",
params={"wait": "true"},
headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
json={"params": {
"urls": [
"https://x.com/github/status/2082201573976056245",
"https://twitter.com/karpathy/status/2002118205729562949",
"https://x.com/thedankoe/status/2010751592346030461"
]
}},
)
job = r.json()
rows = job.get("data", []) # if job["status"] == "running", poll /v1/jobs/{job_id}/results
const r = await fetch("https://api.mindcase.co/v1/data/twitter/articles/run?wait=true", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ params: {
"urls": [
"https://x.com/github/status/2082201573976056245",
"https://twitter.com/karpathy/status/2002118205729562949",
"https://x.com/thedankoe/status/2010751592346030461"
]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
Response fields
Each row indata is one article, keyed by these fields.
| Field | Name | Type |
|---|---|---|
tweetUrl | Tweet URL | url |
tweetId | Tweet ID | text |
articleId | Article ID | text |
title | Title | text |
previewText | Preview Text | text |
articleText | Article Text | text |
articleMarkdown | Article Markdown | text |
contentBlocks | Content Blocks | object_array |
postedDate | Posted Date | text |
lifecycle | Lifecycle | object |
views | Views | number |
likes | Likes | number |
retweets | Retweets | number |
replies | Replies | number |
quotes | Quotes | number |
bookmarks | Bookmarks | number |
coverImage | Cover Image | url |
authorId | Author ID | text |
author | Author | object |
Example response
Abridged: long text and lists are shortened.{
"job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
"agent": "twitter/articles",
"status": "completed",
"row_count": 1,
"truncated": false,
"data": [
{
"retweets": 237,
"author": {
"id": "7080152",
"name": "X Corp. Japan",
"username": "XcorpJP",
"createdAt": "Tue Jun 26 01:54:35 +0000 2007",
"description": "Xの日本公式アカウントです。",
"favouritesCount": 1312,
"followersCount": 1941052,
"followingCount": 14,
"isBlueVerified": true,
"isTranslator": false,
"isVerified": true,
"mediaCount": 1239,
"profileBannerUrl": "https://pbs.twimg.com/profile_banners/7080152/1786924333",
"profilePicture": "https://pbs.twimg.com/profile_images/2089138181958750208/O8e1UraG_normal.jpg",
"profilePictureOriginal": "https://pbs.twimg.com/profile_images/2089138181958750208/O8e1UraG.jpg",
"protected": false,
"statusesCount": 13254,
"url": ""
},
"bookmarks": 573,
"authorId": "7080152",
"postedDate": "2026-03-25T03:00:38Z",
"tweetId": "2036639365498335463",
"contentBlocks": [
{
"type": "header-two",
"text": "Xにいる日本のクリエイターの皆さんへ朗報です!",
"inlineStyleRanges": [
{
"offset": 0,
"length": 23,
"style": "Bold"
}
]
},
{
"type": "paragraph",
"text": "Xでは才能あふれるライターの皆さんによる高品質な記事投稿が現在どんどん増えていることをとても嬉しく思います——そしてその勢いはますます加速しています!",
"inlineStyleRanges": []
}
],
"articleId": "2036598356211015680",
"previewText": "Xでは才能あふれるライターの皆さんによる高品質な記事投稿が現在どんどん増えていることをとても嬉しく思います——そしてその勢いはますます加速しています! 今月から、X Corp. Japan は毎月(3月から開始)、その月に投稿された記事からTop 10を選出します。\n(終了日未定:終了の際は事前にお知らせします)...",
"likes": 1003,
"lifecycle": {
"modified_at_secs": 1774407638
},
"tweetUrl": "https://x.com/XcorpJP/status/2036639365498335463",
"views": 557711,
"replies": 81,
"coverImage": "https://pbs.twimg.com/media/HENzcv5aIAM8P54.png",
"articleMarkdown": "## **Xにいる日本のクリエイターの皆さんへ朗報です!**\n\nXでは才能あふれるライターの皆さんによる高品質な記事投稿が現在どんどん増えていることをとても嬉しく思います——そしてその勢いはますます加速しています!\n\n今月から、**X Corp. Japan** は毎月(3月から開始)、**その月に投稿された記事...",
"title": "クリエイター収益10万円増額!𝕏 記事コンテスト開催",
"quotes": 281,
"articleText": "Xにいる日本のクリエイターの皆さんへ朗報です!\n\nXでは才能あふれるライターの皆さんによる高品質な記事投稿が現在どんどん増えていることをとても嬉しく思います——そしてその勢いはますます加速しています!\n\n今月から、X Corp. Japan は毎月(3月から開始)、その月に投稿された記事からTop 10を選出しま..."
}
]
}
Related APIs
For regular tweets usetwitter/tweets.