# Scrapier — Truth Social API > Scrapier endpoints for Truth Social: Truth Social Posts, Truth Social Profile Info, Truth Social Single Post, TruthSocial Profile Info. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/truth-social.md ## GET /truth-social-posts/ Truth Social Posts: Structured Truth Social data: send `usernames`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts Parameters: - usernames (required, string, example realDonaldTrump): Truth Social username, with or without leading "@". Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/truth-social-posts/?usernames=realDonaldTrump" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/truth-social/truth-social-posts.md ## GET /truth-social-profile-scraper/ Truth Social Profile Info: Structured Truth Social data: send `handles`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.profile Parameters: - handles (required, string, example realDonaldTrump): Truth Social handle. Lookup endpoint -- next_cursor null. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/truth-social-profile-scraper/?handles=realDonaldTrump" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/truth-social/truth-social-profile-scraper.md ## GET /truth-social-single-post/ Truth Social Single Post: Structured Truth Social data: send `urls`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.post Parameters: - urls (required, string, example https://truthsocial.com/@realDonaldTrump/posts/117312693997244079): Truth Social post URL or bare status id. Lookup endpoint -- next_cursor null. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/truth-social-single-post/?urls=https%3A%2F%2Ftruthsocial.com%2F%40realDonaldTrump%2Fposts%2F117312693997244079" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/truth-social/truth-social-single-post.md ## GET /truthsocial-profile-info/ TruthSocial Profile Info: Structured Truth Social data: send `handles`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.profile Parameters: - handles (required, string, example realDonaldTrump): The Truth Social account: "realDonaldTrump", "@realDonaldTrump", a profile URL (https://truthsocial.com/@realDonaldTrump, a / tail or the /users/ form is fine) or realDonaldTrump@truthsocial.com; case does not matter -> ONE profile record: the public Account entity verbatim (id, username, display_name, note / bio, avatar / header, followers_count, following_count, statuses_count, created_at, verified, premium, website ...), likes_count (likes received) and computed{engagement_rate, language, content_category}. Single lookup: next_cursor is always null. An unknown / suspended / moved account answers a status record (not_found | account_suspended | moved | invalid_input) + status_note. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - compute_metrics (optional, boolean, default true, locked in cursor): true (default) = sample the latest `feed_sample` original truths for computed.language / engagement_rate / content_category. false = profile only (1 request; engagement_rate / language null, category from the bio). - feed_sample (optional, integer, default 20, locked in cursor): Original truths sampled for the computed block (1..100, default 20 = one statuses page). - count_likes (optional, boolean, default true, locked in cursor): true (default) = walk the status history (~20 a call) and sum favourites_count -> likes_count (likes received). false = likes_count null. - likes_max_posts (optional, integer, default 100, locked in cursor): Cap on the likes walk in statuses seen (default 100 = 5 pages). Capped at 600 (30 pages, ~20 s proxied) plus a 60 s wall-clock budget on the walk: past either likes_count is a lower bound (stats.likes_count_complete false + warning). Cloudflare allows ~6 statuses calls / minute / IP - proxied the walk hops to a fresh US exit, direct it sleeps. - statuses_per_minute (optional, integer, default 6, locked in cursor): Statuses requests per minute the scraper paces itself to (default 6). - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/truthsocial-profile-info/?handles=realDonaldTrump" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/truth-social/truthsocial-profile-info.md