truth-social/
user-posts

The Truth Social User Posts API takes a public username or numeric user_id and retrieves available account posts with normalized text, author, media, timestamps, and engagement data.

Truth Social User Posts API

Username or user_id
Public account posts
0.19 credits/task
0.19 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Truth Social User Posts

Truth Social User Posts retrieves posts from a known public account. Each task identifies the account by username or numeric user_id, performs one collection request, and returns consistent post records.

Truth Social User Posts API Features

  • Two account identifiersUse a public username or a digits-only user_id. At least one identifier is required.
  • One batch per taskEach task performs one account-post collection and returns the public posts available in that response without fetching later source pages.
  • Normalized post contentReceive post ID, URL, text, author, publication and collection times, media, hashtags, and mentions in fixed fields.
  • Visible engagementPreserve available like, comment, share, and view counts while keeping unavailable values null.

Truth Social User Posts API Parameters

ParametersRequiredDescription
usernameRequired (at least one)Public username with an optional leading @ followed by 1–64 ASCII letters, digits, periods, underscores, or hyphens. Leading or trailing spaces and profile URLs are not accepted.
user_idRequired (at least one)Digits-only account ID. It can replace username or be submitted together with the matching username.
trimOptionalOptional boolean. Submit true or false when you need to set the option explicitly; omit the field when you do not want to send it.

How to Use the Truth Social User Posts API

Provide a username or user_id to the Truth Social User Posts API, save the task ID, and read the post list after the task succeeds.

  1. Enter a public username or digits-only user_id. In most cases, provide only one identifier.
  2. POST the input to /v1/truth-social/user-posts and save data.task_id from the response.
  3. Poll GET /v1/tasks/{task_id} until the task succeeds or fails.
  4. After success, read data.results.items. Follow next_cursor only when has_more is true for stored results.
curl -X POST "https://api.socq.ai/v1/truth-social/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"realDonaldTrump"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Truth Social User Posts API Use Cases

  • Account content snapshots: Save the currently available public posts for archiving, review, or scheduled comparison.
  • Content analysis: Classify, search, and process Truth Social User Posts API results using consistent text, author, media, and timestamp fields.
  • Engagement observation: Compare visible likes, comments, shares, and views together with collected_at as the observation time.

Truth Social User Posts API Pro Tips

  • Prefer a verified username. If another account result provides a numeric author.id, it can be reused as user_id.
  • Do not place a profile URL in username or user_id.
  • When both identifiers are supplied, make sure they refer to the same account because both values are forwarded.
  • This endpoint does not accept results_limit or a source cursor; each task collects once.
  • next_cursor only advances through saved task results and does not collect more source posts.

Beyond the Truth Social User Posts API, use these APIs when you need a different type of public Truth Social data.

  • Truth Social Post API — Resolve one known Truth Social post URL into normalized content, author context, media, timestamps, and available visible engagement fields.
  • Truth Social Profile API — Retrieve one public Truth Social profile by username with normalized identity, biography, profile media, account flags, location, visible counts, and collection context.

Explore other platforms

Combine Truth Social data with public data from other supported social platforms.

Truth Social User Posts API — FAQ

Truth Social User Posts API retrieves public account posts by username or numeric user_id and returns normalized text, author, media, timestamps, and visible engagement data.

At least one is required. Use username in most cases, or use user_id when you already have the account's numeric ID.

Yes, but both values are forwarded to collection, so they should identify the same account.

trim is an optional boolean. Set it only when you need to explicitly choose true or false; otherwise it can be omitted.

No. Each task performs one source collection. next_cursor only paginates records already saved for that task.

Each successful Truth Social User Posts API task costs a fixed 0.19 credits, regardless of the number of posts returned.