X Articles API
curl --request POST \
--url https://api.socq.ai/v1/x/article \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"<string>"
],
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/x/article"
payload = {
"urls": ["<string>"],
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({urls: ['<string>'], callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/x/article', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/x/article",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'urls' => [
'<string>'
],
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/x/article"
payload := strings.NewReader("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/x/article")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/x/article")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}X
X Articles
Collect the title, full text and engagement of X Articles.
POST
/
v1
/
x
/
article
X Articles API
curl --request POST \
--url https://api.socq.ai/v1/x/article \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"<string>"
],
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/x/article"
payload = {
"urls": ["<string>"],
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({urls: ['<string>'], callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/x/article', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/x/article",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'urls' => [
'<string>'
],
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/x/article"
payload := strings.NewReader("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/x/article")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/x/article")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}X Articles
Read X Articles, the long-form posts with a title, cover image and formatted body, as clean text. Pass the URL of the post that publishes the Article and get back its title, the preview line shown in timelines, the full body with paragraphs separated by blank lines, the cover image, the author and its likes, replies, quotes and views. Use it to archive long-form writing, feed it to a summarizer or language model, or track how Articles perform compared with regular posts.{
"urls": [
"https://x.com/USDOL/status/2119796255089947070"
]
}
Standard Result Fields
Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | ID of the post that publishes the Article. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | URL of the post that publishes the Article. |
published_at | string | Yes | Time the Article was published, in ISO 8601 format. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
title | string | Yes | Title of the Article. |
summary | string | Yes | Preview text X shows for the Article in timelines. |
text | string | Yes | Full text of the Article, with paragraphs separated by blank lines. |
cover_url | string | Yes | URL of the Article’s cover image. |
author | object | Yes | Author or publisher of the content. |
author.id | string | Yes | Unique identifier of the author. |
author.username | string | Yes | Public username or handle of the account. |
author.name | string | Yes | Display name of the author. |
author.url | string | Yes | Public URL of the author when available. |
author.avatar_url | string | Yes | URL of the account avatar image. |
author.is_verified | boolean | Yes | Whether the account is verified on the platform. |
author.is_private | boolean | Yes | Whether the account is private. |
metrics | object | Yes | Counters and measurements available for the result item. |
metrics.likes_count | integer | Yes | Number of likes. |
metrics.comments_count | integer | Yes | Number of comments. |
metrics.quotes_count | integer | Yes | Number of quote posts. |
metrics.views_count | integer | Yes | Number of views reported by the platform. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-x-article",
"status": "succeeded",
"public_id": "x/article",
"result_count": 1,
"credits_amount": 0.7,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "article",
"schema_version": "1.0",
"items": [
{
"id": "2119796255089947070",
"platform": "x",
"resource": "article",
"type": "article",
"url": "https://x.com/USDOL/status/2119796255089947070",
"published_at": "2026-11-09T14:16:25Z",
"collected_at": "2026-11-13T10:15:28Z",
"title": "DOL proposes rule setting national minimum weekly work search requirement for unemployment insurance",
"summary": "Rule would set a baseline of five weekly activities, require reporting before payment\nWASHINGTON – The U.S. Department of Labor’s Employment and Training Administration today announced a proposed rule",
"text": "Rule would set a baseline of five weekly activities, require reporting before payment\n\nWASHINGTON – The U.S. Department of Labor’s Employment and Training Administration today announced a proposed rule designed to improve the integrity and accountability of the Federal-State Unemployment Insurance Program by establishing a national minimum weekly work search standard for individuals claiming unemployment insurance benefits.\n\nUnder the proposed rule, individuals claiming unemployment insurance benefits would be required to complete at least five qualifying work-search activities each week and to report those activities before payment is issued.",
"cover_url": "https://pbs.twimg.com/media/HWsGO1ZWIAA9H64.jpg",
"author": {
"id": "20179628",
"username": "USDOL",
"name": "U.S. Department of Labor",
"url": "https://x.com/USDOL",
"avatar_url": "https://pbs.twimg.com/profile_images/2073447109181792256/0-odXb12_normal.jpg",
"is_verified": false,
"is_private": null
},
"metrics": {
"likes_count": 156,
"comments_count": 19,
"quotes_count": 4,
"views_count": 37793
}
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json

