Don't invest unless you're prepared to lose all the money you invest. This is a high-risk investment and you should not expect to be protected if something goes wrong. Take 2 mins to learn more.

DecryptrDevelopers
People and posts

A public list and its members

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. A public list and a page of its members: people (only those who are listed) and topics.

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 pro plan or above.

How calls are counted

Authorization

headerAuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>

Your API key as a Bearer token: Authorization: Bearer dcr_live_....

Path Parameters

id*string

List id.

Formatuuid

Query Parameters

cursor?string

next_cursor from the previous page, passed back as it is. Opaque: do not build or change it.

Lengthlength <= 300
limit?integer

Items to return, 1 to 100. Your plan allows max_page calls per request (Developer 10, Starter 25, Pro 50, Business 100), so at most max_page divided by this endpoint's calls per item. Default 20, or that maximum if lower. The request reserves limit x calls per item before it runs: ask only for what you need.

Range1 <= value <= 100

Response Body

OK.

application/json
  1. response
data*array<>
as_of*string

When the response was made.

Formatdate-time
next_cursor*|

Pass as cursor for the next page. null when this is the last page.

list*

A public list.

disclaimer*string

Plain-language notice. Information only, not financial advice.

Example Request
curl -X GET 'https://data.decryptr.ai/v1/lists/00000000-0000-4000-8007-000000000001?cursor=eyJ0IjoiMjAyNi0xMC0yM1QxMDowMDowMC4wMDBaIn0&limit=10'
Example Response
{  "data": [    {      "kind": "person",      "person": {        "id": "trd_000000000000000000000001",        "handle": "sample_user_1"      },      "topic": null,      "added_at": "2026-09-01T00:00:00.000Z"    },    {      "kind": "person",      "person": {        "id": "trd_000000000000000000000002",        "handle": "sample_user_2"      },      "topic": null,      "added_at": "2026-09-01T01:00:00.000Z"    },    {      "kind": "person",      "person": {        "id": "trd_000000000000000000000003",        "handle": "sample_user_3"      },      "topic": null,      "added_at": "2026-09-01T02:00:00.000Z"    }  ],  "next_cursor": "eyJ0IjoiMjAyNi0wOS0wMVQwMjowMDowMC4wMDBaIiwiaCI6InRyZF8wMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDMifQ",  "as_of": "2026-10-23T12:28:30.000Z",  "list": {    "id": "00000000-0000-4000-8007-000000000001",    "name": "Sample list",    "description": "Sample callers and topics.",    "owner": {      "id": "trd_000000000000000000000001",      "handle": "sample_user_1"    },    "members": 30,    "created_at": "2026-09-01T00:00:00.000Z",    "updated_at": "2026-10-01T00:00:00.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."}