> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# X Articles

> Collect the title, full text and engagement of X Articles.

# 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.

```json theme={"dark"}
{
  "urls": [
    "https://x.com/USDOL/status/2119796255089947070"
  ]
}
```

Provide the X post URLs that publish each Article in urls, using /{username}/status/{post_id}. Each Article returns one row. A post that is not an Article returns no row; when none of the URLs is an Article, the task fails and is not charged.

## 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, use `fields` 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. |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "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
          }
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/x/article
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-1fa58609f514
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/x/article:
    post:
      tags:
        - x
      summary: X Articles API
      description: Collect the title, full text and engagement of X Articles.
      operationId: socq_x_article
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                urls:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 1
                  description: Public profile or content URLs.
              required:
                - urls
              description: >-
                Provide the X post URLs that publish each Article in urls, using
                /{username}/status/{post_id}.
      responses:
        '200':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.