# Social Fetch API - Truth Social endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

3 documented Truth Social operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/truthsocial/profiles/{handle}
Get Truth Social profile
Credit cost: 2 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/truthsocial/profiles/handle/get.mdx
SDK: client.truthsocial.getProfile({ handle: "realDonaldTrump" })
Parameters:
- handle (required, string) - Truth Social handle or account id.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/truthsocial/profiles/realDonaldTrump" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/truthsocial/profiles/{handle}/posts
List Truth Social profile posts
Credit cost: 2 credits base, +2 with `includeReplies`. Up to 4 credits max.
Docs: https://www.socialfetch.dev/docs/api/v1/truthsocial/profiles/handle/posts/get.mdx
SDK: client.truthsocial.getProfilePosts({ handle: "realDonaldTrump" })
Parameters:
- handle (required, string) - Truth Social handle or account id.
- cursor (optional, string) - Opaque pagination cursor from a previous response. Omit for the first page.
- includeReplies (optional, boolean) - When true, includes reply posts in the timeline. Adds 2 credits (4 total including the base lookup). Default: false (top-level posts only).
- limit (optional, integer) - Maximum posts to return (1–20). Default: 20.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/truthsocial/profiles/realDonaldTrump/posts" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/truthsocial/posts
Get Truth Social post
Credit cost: 2 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/truthsocial/posts/get.mdx
SDK: client.truthsocial.getPost({ url: "https://truthsocial.com/@justthenews/116972401572691045" })
Parameters:
- url (required, string) - Link to the Truth Social post.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/truthsocial/posts?url=https://truthsocial.com/@justthenews/116972401572691045" \
  -H "x-api-key: YOUR_API_KEY"