Truth Social API: The Complete Guide to Real-Time Monitoring (2026)

Why there's no official API

Truth Social is built on a fork of Mastodon, the open-source social server. Mastodon itself has a well-documented API, and Truth Social inherited much of that surface internally, but Truth Social never opened a developer program. There are no third-party API keys, no documented endpoints, no rate limit policy, and no support channel. The internal endpoints exist and can change or lock down at any time without notice.

That matters because Truth Social posts move markets. Posts from political figures, most obviously @realDonaldTrump, routinely move prediction-market odds on Polymarket and Kalshi, and sometimes equities and crypto, within seconds. The gap between "no official API" and "market-moving content" is why a whole ecosystem of monitoring approaches exists.

Option 1, Open-source scrapers (free, slow, yours to maintain)

The best-known open-source tool is truthbrush(from the Stanford Internet Observatory), a Python library that authenticates with a Truth Social account and pulls statuses, search results, and user data. GitHub also has assorted scrapers wrapping the same internal endpoints.

What you sign up for with this route:

• Polling latency. You poll on an interval. Poll every 30 seconds and your worst-case detection is 30+ seconds, an eternity for trading use cases.
• Account and IP risk. Scrapers authenticate as a regular account; aggressive polling gets accounts and IPs blocked, so you rotate both.
• Breakage. When internal endpoints change, your pipeline is down until someone patches the library.
• Cost is your time. Free software, but you are now operating scraping infrastructure.

Fine for research and historical analysis. Painful for live monitoring.

Option 2, Pay-per-call scraper APIs

Services like ScrapeCreators and Apify actors expose Truth Social data as a paid HTTP API: you send a request, they scrape and return JSON, you pay per call. They solve the maintenance problem, but not the latency problem. You are still polling; you just outsourced the scraping. At a 10-second poll on one account, a per-call price of even a fraction of a cent compounds to hundreds of dollars a month, for ONE account, with 10-second worst-case latency.

Good for: occasional lookups, backfills, research queries. Wrong shape for: "tell me the instant this account posts."

Option 3, Managed real-time feeds (push, not poll)

The third model inverts the problem: a provider runs the detection layer continuously and pushes new posts to you the moment they are detected. 1322's Truth Social feed works this way, you put accounts on a tracked list, keep a WebSocket open, and receive structured JSON events typically within a few hundred milliseconds of publication: new truths, retruths with the full quote chain, profile changes, deletions and pins. No Truth Social credentials, no scraping infrastructure, flat monthly price.

A minimal Python consumer:

import asyncio, json, websockets

API_KEY = "your-1322-api-key"

async def main():
    async with websockets.connect(
        "wss://1322.io/your-ws-path", # from your dashboard /api-access page
        additional_headers={"X-Api-Key": API_KEY}, ) as ws:
        async for raw in ws:
            event = json.loads(raw)
            if event.get("platform") == "truth" and event.get("eventType") == "post":
                handle = event["handle"]
                text = event.get("content", "")
                print(f"[{event['timestamp']}] @{handle}: {text[:120]}")
                # -> match against your prediction markets / alert rules here

asyncio.run(main())

Delivery also works without writing a consumer at all: the included Discord bot and Telegram bot post tracked-account events directly to your server or chat, and signed webhooks can hit your backend.

The prediction-market angle

The highest-value use of Truth Social monitoring in 2026 is prediction markets. The pattern: a tracked political account posts → relevant Polymarket/Kalshi odds move within seconds → the first actors capture the spread. A push feed with sub-second detection is the difference between being the mover and being the market. 1322 customers typically pair the Truth Social feed with the news feed in the same WebSocket, a post corroborated by a matching headline within seconds is a much stronger signal than either alone. More on this setup: prediction market data feed.

Honest comparison

If you need historical research at zero cost, run truthbrush. If you need occasional lookups, use a per-call API. If you need to know the moment a tracked account posts, use a push feed, see the Truth Social monitoring API.

FAQ