# SocialCrawl API — truthsocial endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/truthsocial

## GET /v1/truthsocial/profile
Get Truth Social user profile
Credit cost: 1 (standard)
Parameters:
- handle (required) — Truth Social username without the @ symbol
curl "https://www.socialcrawl.dev/v1/truthsocial/profile?handle=realDonaldTrump" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/truthsocial/user/posts
List Truth Social user posts
Credit cost: 1 (standard)
Parameters:
- handle (optional, string) — Truth Social username without the @ symbol
- user_id (optional, string) — Truth Social user id. Use this for faster response times. Trumps is 107780257626128497. It is the 'id' field in the profile endpoint.
- next_max_id (optional, string) — Used to paginate to next page
- trim (optional, boolean) — Set to true for a trimmed down version of the response
- Constraint: one of handle, user_id (at least one required)
curl "https://www.socialcrawl.dev/v1/truthsocial/user/posts" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/truthsocial/post
Get Truth Social post details
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Truth Social post
curl "https://www.socialcrawl.dev/v1/truthsocial/post?url=https://truthsocial.com/@realDonaldTrump/posts/123456789" \
  -H "x-api-key: sc_your_api_key_here"