For Developers

Trusti Archive API

This free, open, read-only API was created to provide the public with an easy-to-use version of the Trusti blacklist archive for use in your own projects. No key is required to use this API.

Rate limits

Default limits: 5 requests / 10 seconds and 20 requests / minute

Responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Exceeding a limit returns 429 with Retry-After.

Please be mindful of your usage of this free API. We encourage you to cache successful responses where possible, as this dataset does not change.

Endpoints

  • GET/api/v1/stats

    Total visible report count and category breakdown.

  • GET/api/v1/search?q={query}&limit=25&offset=0

    Search by Discord user/server id, alt id, name, or report id.

  • GET/api/v1/reports/{id}

    Full report detail including evidence URLs and linked alts.

  • GET/api/v1/targets/{discordId}

    All reports for a Discord user or server id (includes alt matches).

Example

curl -s "https://trustiarchive.xyz/api/v1/search?q=1234567890"

← Back to archive search