One public post
get/v1/posts/{id}
https://data.decryptr.ai/v1/posts/{id}
- API planPro and above
- Scope
social:read - Cost1 unit, also when not found. How units are counted
Rate limits by plan
| Plan | Units a month | Per second | Per minute | Most per request |
|---|---|---|---|---|
| Pro | 300,000 | 15 | 300 | 50 |
| Business | 1,500,000 | 40 | 900 | 100 |
| Enterprise | Agreed | Agreed | Agreed | Agreed |
A 429 carries the full rate-limit header set and a Retry-After. Rate limits
Errors
- 400The request was refused before any data was read. Nothing is charged.
- 401No usable key. Nothing is charged.
- 402The account cannot use the API until billing is sorted. Nothing is charged.
- 403The key may not use this endpoint. Nothing is charged.
- 404No such item. A lookup is still charged what it asked for.
- 429A limit was reached (units or streams). Nothing was read and nothing is charged. Wait Retry-After seconds, back off with jitter, or ask for fewer items.
- 500Something failed on our side. Nothing is charged. Retry with backoff.
- 503The API is switched off, busy, or a query ran too long. Nothing is charged. Retry after Retry-After seconds.
Errors follow RFC 9457. Every error code
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. One public post or reply by id.
Cost: 1 unit, also when not found.
Needs scope social:read and the pro plan or above.
AuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>Your API key as a Bearer token: Authorization: Bearer dcr_live_....
id*stringPost id.
uuidOK.
application/json- response
data*A public post. Text and counts only: never images, GIFs, trade or PnL cards, polls' votes, likers or viewers.
as_of*stringWhen the response was made.
date-timedisclaimer*stringPlain-language notice. Information only, not financial advice.
curl -X GET 'https://data.decryptr.ai/v1/posts/00000000-0000-4000-8005-000000000096'{ "data": { "id": "00000000-0000-4000-8005-000000000096", "author": { "id": "trd_00000000000000000000000b", "handle": "sample_user_11" }, "text": "Sample post 150 about $SOL.", "asset": "SOL", "community": "sample-community", "created_at": "2026-10-23T06:30:00.000Z", "edited_at": null, "counts": { "likes": 0, "replies": 2, "reposts": 2, "views": 150 }, "quote_of": null, "reply_to": null, "thread_root": null, "kind": null, "sensitive": false, "has_media": false }, "as_of": "2026-10-23T12:20:30.000Z", "disclaimer": "Public content of Decryptr users who have not opted out. Apply every /v1/tombstones entry within 24 hours. Do not resell it, republish it in bulk or use it to train AI models."}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. Public top-level posts, newest first, filtered by author, asset or community. Text and counts only. Cost: 1 unit per item returned, at least one item's worth. The request first reserves limit x 1 unit (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `social:read` and the pro plan or above.
Replies to a public post 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. Replies to a public post, oldest first. 404 when the post itself is not served. Cost: 1 unit per item returned, at least one item's worth. The request first reserves limit x 1 unit (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `social:read` and the pro plan or above.