Truth Social Post
Truth Social Post resolves one known public post. Submit the post URL to receive at most one normalized record for link enrichment, content review, and scheduled engagement snapshots.
Features
- Exact URL lookupSubmit one public truthsocial.com post URL per task without keyword search.
- Complete post contentReceive post ID, public URL, text, publication time, and collection time.
- Author and media contextPreserve available author identity, avatar, account status, media, hashtags, and mentions.
- Engagement snapshotRecord visible like, comment, share, and view counts while keeping unavailable values null.
Parameters
| Parameters | Required | Description |
|---|---|---|
url | Required | Required full URL for a public Truth Social post. The parsed hostname must be truthsocial.com or a subdomain. Include http or https and submit an actual post path. |
How to Use
Submit a real public post URL, save the task ID, and read the post details after completion.
- Use the default public post URL or replace it with the full Truth Social post link you want to retrieve.
- POST url to /v1/truth-social/post and save data.task_id from the response.
- Poll GET /v1/tasks/{task_id} until the task succeeds or fails.
- After success, read the normalized post record from data.results.items.
curl -X POST "https://api.socq.ai/v1/truth-social/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://truthsocial.com/@realDonaldTrump/117091934703272898"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successBest Use Cases
- Post link enrichment: Convert a known post link into searchable text, author, timestamp, and source fields.
- Selected content review: Retrieve the text, author, and attachments for a specific public post in a review workflow.
- Engagement change tracking: Repeat a lookup on a schedule and compare public engagement together with collected_at.
Pro Tips
- Submit the full URL for an actual post, not a profile, search page, or another Truth Social page.
- The URL must include http or https and use truthsocial.com or one of its subdomains.
- Passing URL validation does not guarantee that the post exists or remains publicly accessible.
- Treat author details, media, hashtags, mentions, and engagement data as nullable fields.
- This endpoint does not accept results_limit or a source cursor and returns at most one post record per task.
Related APIs
Use these APIs when you need a different type of public Truth Social data.
- 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.
- Truth Social User Posts API — Collect one source page of public Truth Social posts by username or numeric account ID with normalized content, authors, media, timestamps, and visible engagement.