CORE API

X user posts API

user_posts on X: 0.5 credits per successful call, with clear inputs, source data and billing.

01 / CORE API

One request

0.5 credits per successful or empty call. Failed calls cost 0.

Replace any PASTE_PUBLIC placeholder with a supported public identifier. This is a request template; it does not run automatically.

REQUEST TEMPLATE

curl --request POST 'https://api.socialtoai.com/v1/user_posts' \
  --header "X-API-Key: $SOCIALTOAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
  --data '{"platform":"x","user":"PASTE_PUBLIC_ACCOUNT_ID"}'

02 / CORE API

Native support

Result shape: item. Pagination: returned opaque cursor.

These values describe the reference card. Additional restrictions can apply to user discovery or a content subtype. Inspect applied_params and warnings instead of assuming an unsupported filter was honored.

03 / CORE API

A schema-checked example

Illustrative result with one invented value and an example trial balance. It shows the response shape; it is not a live response or a production availability measurement.

ILLUSTRATIVE JSON · NOT LIVE

{
  "request_id": "example_only_not_a_live_call",
  "schema_version": "v1",
  "fetched_at": "2026-09-05T00:00:00Z",
  "status": "ok",
  "applied_params": {},
  "warnings": [],
  "items": [
    {
      "kind": "item",
      "id": "EXAMPLE_ITEM_ID",
      "author": {
        "name": "example_author"
      },
      "published_at": "2026-09-01T08:30:00Z",
      "metrics": {
        "likes": 412,
        "comments": 96
      },
      "title": "Illustrative post title",
      "text": "Illustrative excerpt, not real content."
    }
  ],
  "platform": "x",
  "billing": {
    "cost": 0.5,
    "balance": 1.5,
    "unit": "credits",
    "pricing": "standard"
  }
}

04 / CORE API

Platform limitations

Search count is limited to 1–20 before any upstream request. Source pagination can be unstable; continuation failure is reported rather than silently returning the first page.

Only relevance and latest are native sorts. Other popularity sorts are approximations with warnings. Time and media filters use advanced-search operators.

Trending is Worldwide only, without location, count or pagination parameters.

Comments contain direct replies to the requested post or reply branch.

Profiles require a username or profile URL; numeric IDs are not silently used as usernames. Creator posts also accept a user ID.

All X actions →

Frequently asked questions

What does this call cost?

0.5 credits for a successful or empty lookup. Failed calls cost 0 credits.

Can I paginate?

Use only the returned opaque cursor, preserving the platform and query. Check has_more and your remaining budget.

Are all platform features covered?

Search count is limited to 1–20 before any upstream request. Source pagination can be unstable; continuation failure is reported rather than silently returning the first page. Only relevance and latest are native sorts. Other popularity sorts are approximations with warnings. Time and media filters use advanced-search operators. Trending is Worldwide only, without location, count or pagination parameters. Comments contain direct replies to the requested post or reply branch. Profiles require a username or profile URL; numeric IDs are not silently used as usernames. Creator posts also accept a user ID.

YOUR AI. A WIDER VIEW.

Start with one good question.

Get 2 free credits ↗

No card. Read-only public data. Explicit limits and transparent credits.