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.
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.
Parameters
| Parameters | Required | Description |
|---|---|---|
username | Required (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_id | Required (at least one) | Digits-only account ID. It can replace username or be submitted together with the matching username. |
trim | Optional | Optional 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
Provide a username or user_id, save the task ID, and read the post list after the task succeeds.
- Enter a public username or digits-only user_id. In most cases, provide only one identifier.
- POST the input to /v1/truth-social/user-posts and save data.task_id from the response.
- Poll GET /v1/tasks/{task_id} until the task succeeds or fails.
- 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 successBest Use Cases
- Account content snapshots: Save the currently available public posts for archiving, review, or scheduled comparison.
- Content analysis: Classify, search, and process posts 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.
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.
Related APIs
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.