Truth Social APIs
Retrieve public account details, collect one source page of account posts, or resolve one known post URL into normalized records.
Available Truth Social APIs
Use Profile for one username, User Posts for a username or numeric account ID, and Post for one known truthsocial.com post URL.
What Truth Social data can you retrieve?
Results use stable account and post schemas while source-dependent fields remain nullable.
Profile identity
Read available username, display name, biography, profile media, website, account flags, location, and visible counts.
Post content
Retrieve normalized post identity, public URL, text, author context, publication time, and collection time.
Media and engagement
Use available attachments, hashtags, mentions, and visible like, comment, share, and view counters.
Choose a Truth Social API
Each endpoint has a bounded source input and shares the same asynchronous task workflow.
| Endpoint | Input | Source scope |
|---|---|---|
| Profile | One username | One public account |
| User Posts | Username or numeric user ID | One provider response page |
| Post | One truthsocial.com URL | At most one public post |
How Truth Social collection works
Submission and stored-result retrieval are separate stages.
1. Choose the endpoint
Select Profile, User Posts, or Post for the public resource you already know.
2. Track the task
Save task_id and poll /v1/tasks/{task_id} until success or failure.
3. Read saved records
After success, read data.results.items and follow next_cursor only while stored results have another page.
Supply a valid public selector and authenticate with a SocQ API key.
curl -X POST "https://api.socq.ai/v1/truth-social/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"realDonaldTrump"}'Common Truth Social API uses
Public account enrichment
Attach available identity, biography, imagery, flags, and counts to a known public username.
Account post snapshots
Store the post records exposed for a selected account at a known collection time.
Known-post review
Normalize one public post with its available author, media, timestamps, and visible engagement.
Scope and boundaries
These endpoints read public data available during collection and do not provide account-management actions.
- Profile requires one username using the optional-@ pattern.
- User Posts requires username or a digits-only user_id; both values are forwarded when both are supplied, and trim is an optional boolean.
- Post requires a non-empty URL whose parsed hostname is truthsocial.com or a subdomain.
- The requests do not accept results_limit or a provider cursor.
- Result cursor and limit paginate records already stored by SocQ rather than fetching another source page.
Truth Social API FAQ
Which Truth Social APIs are available?
Profile retrieves one public account, User Posts collects one source page for a username or numeric account ID, and Post resolves one known public post URL.
Can User Posts accept both username and user_id?
Yes. At least one is required, and the backend forwards both non-empty values without declaring one as the winner.
Does next_cursor collect more source posts?
No. It only advances through records already stored after the task succeeds.
What does collection cost?
Each successful Truth Social task has a fixed charge of 0.19 SocQ credits.
Combine data across platforms for more complete business insights
Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.
LinkedIn API
Retrieve public LinkedIn profile, company, post, and job data from known URLs, with normalized identity, career, company, content, engagement, and job fields.
Reddit API
Retrieve public Reddit posts and comments from known URLs, browse new, top, or hot subreddit posts, or search discussions by keyword and publication window.
Rednote API
Retrieve public profiles and notes, search notes or users, collect comments and nested replies, and capture one home recommendation page.
Pinterest API
Retrieve public Pinterest profile data, resolve known Pins, collect Pins from selected profiles, or search by keyword for creator, content, and visual trend research.
Threads API
Retrieve public Threads profiles, resolve known posts, or collect posts from selected profiles with normalized identity, content, media, engagement, and timestamp fields.
Bluesky API
Retrieve public Bluesky profiles, resolve known post URLs, or collect one page of account posts with normalized identity, content, media, timestamps, and visible engagement fields.