Live public post stream (SSE)
Person-level data (on since 23 Oct 2026): only public accounts that have not opted out (API visibility), never private, banned or suspended accounts, and only content created on or after Decryptr's content date. Authors carry a pseudonymous id (trd_). When content is deleted, hidden or its author leaves, /v1/tombstones lists it: delete your copy within 24 hours. Server-sent events of new public posts: id (<created_at ms>.<post id>), event: post, data (a Post as JSON). A new connection starts from now; send Last-Event-ID to resume where you left off. Closes after about 2 minutes with an end event; reconnect and nothing is missed. Business: 10 connections, shared with the signal stream.
Cost: connecting is free; 1 call per event delivered, taken before it is sent.
Needs scope stream:read and the business plan or above.
AuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>Your API key as a Bearer token: Authorization: Bearer dcr_live_....
Last-Event-ID?stringResume after this event id.
^[0-9]{13}\.[0-9a-f-]{36}$OK.
response?stringtext/event-streamA stream of server-sent events.
curl -X GET 'https://data.decryptr.ai/v1/stream/posts' \ -H 'Last-Event-ID: 1792756800000.00000000-0000-4000-8005-0000000000c8'"retry: 3000\n\nid: 1792756800000.00000000-0000-4000-8005-0000000000c8\nevent: post\ndata: {\"id\":\"00000000-0000-4000-8005-0000000000c8\",\"author\":{\"id\":\"trd_000000000000000000000001\",\"handle\":\"sample_user_1\"},\"text\":\"Sample post 200 about $BTC.\",\"asset\":\"BTC\",\"community\":null,\"created_at\":\"2026-10-23T12:00:00.000Z\",\"edited_at\":null,\"counts\":{\"likes\":0,\"replies\":0,\"reposts\":0,\"views\":100},\"quote_of\":null,\"reply_to\":null,\"thread_root\":null,\"kind\":null,\"sensitive\":false,\"has_media\":false}\n\n: ping\n\nevent: end\ndata: {\"reason\":\"max_duration\",\"reconnect\":true,\"last_event_id\":\"1792756800000.00000000-0000-4000-8005-0000000000c8\"}\n"Search public posts GET
Person-level data (on since 23 Oct 2026): only public accounts that have not opted out (API visibility), never private, banned or suspended accounts, and only content created on or after Decryptr's content date. Authors carry a pseudonymous id (trd_). When content is deleted, hidden or its author leaves, /v1/tombstones lists it: delete your copy within 24 hours. Full-text search of public posts and replies (English, with quoted phrases, OR and -word as in a web search), best match first. Cost: 5 calls per request plus 1 call per result. The request first reserves 5 + limit x 1 calls (and is refused with 429 if that many are not available), then pays for what came back; no results costs 5. Needs scope `social:read` and the pro plan or above.
Public communities GET
Person-level data (on since 23 Oct 2026): only public accounts that have not opted out (API visibility), never private, banned or suspended accounts, and only content created on or after Decryptr's content date. Authors carry a pseudonymous id (trd_). When content is deleted, hidden or its author leaves, /v1/tombstones lists it: delete your copy within 24 hours. The public community directory by slug: user communities and coin communities, with names, descriptions and member counts. Cost: 1 call per item returned, at least one item's worth. The request first reserves limit x 1 calls (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `social:read` and the starter plan or above.