Truth Social Profile
Truth Social Profile looks up a known public account. Submit a username to receive one normalized account record that can be used directly for enrichment, review, and scheduled profile snapshots.
Features
- Exact username lookupQuery one known public username per task without fuzzy account search or profile URLs.
- Consistent account identityReceive account ID, username, display name, public profile URL, biography, and collection time in fixed fields.
- Profile detailsRetrieve avatar, cover image, website, location, verification status, and privacy status when publicly available.
- Visible metric snapshotRecord follower, following, and post counts observed at collection time for later comparison.
Parameters
| Parameters | Required | Description |
|---|---|---|
username | Required | Required public username using 1–64 ASCII letters, digits, periods, underscores, or hyphens. Validation permits one leading @, but the canonical username without @ is recommended. Profile URLs are not accepted. |
How to Use
Submit one public username, save the task ID, and read the account result after completion.
- Enter a known Truth Social username such as realDonaldTrump. For reliable resolution, use the username without a leading @.
- POST username to /v1/truth-social/profile and save data.task_id from the response.
- Poll GET /v1/tasks/{task_id} until data.status becomes succeeded or failed.
- After success, read the normalized account record from data.results.items.
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"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successBest Use Cases
- Account enrichment: Add public identity, biography, profile images, website, and visible metrics to a record that already has a username.
- Account review: Convert public profiles into consistent fields for internal review, classification, and manual inspection.
- Profile change tracking: Save scheduled snapshots and compare biography, imagery, status, and metrics using collected_at.
Pro Tips
- Store the canonical username without @ to avoid multiple forms of the same account.
- Valid syntax does not guarantee that an account exists, is public, or is currently accessible.
- Treat profile images, website, location, status, and metrics as nullable source fields.
- This endpoint returns account details only. Use Truth Social User Posts API for public posts.
- Do not send results_limit or a source cursor; each task performs one account lookup.
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 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.