truth-social/
profile

Send one public username to the Truth Social Profile API to retrieve normalized account identity, biography, profile images, account status, and visible metrics.

Truth Social Profile API

Username lookup
Account profile
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 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.

Truth Social Profile API Features

  • Exact username lookupThe Truth Social Profile API queries 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.

Truth Social Profile API Parameters

ParametersRequiredDescription
usernameRequiredRequired 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 the Truth Social Profile API

Submit one public username, save the task ID, and read the account result after completion.

  1. Enter a known Truth Social username such as realDonaldTrump. For reliable resolution, use the username without a leading @.
  2. POST username to /v1/truth-social/profile and save data.task_id from the response.
  3. Poll GET /v1/tasks/{task_id} until data.status becomes succeeded or failed.
  4. 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 success

Truth Social Profile API 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.

Truth Social Profile API 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.

Beyond the Truth Social Profile 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 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.

Explore other platforms

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

Truth Social Profile API — FAQ

Truth Social Profile API retrieves a normalized public account record by username, including identity, biography, profile images, account status, and visible metrics.

Use the public username without @, such as realDonaldTrump. It can contain ASCII letters, digits, periods, underscores, and hyphens, with a maximum length of 64 characters.

Results can include account ID, username, display name, profile URL, biography, avatar, cover, website, location, verification and privacy status, and follower, following, and post counts.

Validation confirms only the username format. The account may not exist, may be private, or may not be publicly accessible at collection time.

No. It returns profile data only. Use Truth Social User Posts API to retrieve public posts.

The Truth Social Profile API charges a fixed 0.19 credits per successful task. Failed tasks follow the refund policy.