epsteinexposed
Credits: Erwin Lejeune — 2026-02-22
Unofficial Python client for the Epstein Exposed public API.
Search persons, documents, flight logs, and emails from the Epstein case files — programmatically, with both sync and async interfaces.
Disclaimer: Inclusion in the Epstein Exposed database does not imply guilt or wrongdoing. All data is derived from publicly released government records, court filings, and verified reporting. Attribution to epsteinexposed.com is requested.
Installation
pip install epsteinexposed
Quick Start
Synchronous
from epsteinexposed import EpsteinExposed
with EpsteinExposed() as client:
# Search persons
persons = client.search_persons(q="clinton", category="politician")
for p in persons.data:
print(f"{p.name} — {p.stats.flights} flights, {p.stats.documents} docs")
# Get person detail
detail = client.get_person("bill-clinton")
print(detail.bio, detail.aliases)
# Search documents
docs = client.search_documents(q="little st james", source="court-filing")
for d in docs.data:
print(d.title, d.source_url)
# Search flights
flights = client.search_flights(passenger="trump", year=1997)
for f in flights.data:
print(f"{f.date}: {f.origin} → {f.destination}")
# Cross-type search
results = client.search(q="wexner trust", type="documents")
print(len(results.documents.results), "document hits")
Asynchronous
import asyncio
from epsteinexposed import AsyncEpsteinExposed
async def main():
async with AsyncEpsteinExposed() as client:
persons = await client.search_persons(q="maxwell")
for p in persons.data:
print(p.name)
asyncio.run(main())
Cloudflare & TLS Impersonation
The upstream API is behind Cloudflare bot protection, which blocks standard HTTP clients (httpx, requests) with a 403 challenge page. This library uses curl_cffi to impersonate a Chrome browser's TLS fingerprint, bypassing the challenge transparently.
client = EpsteinExposed(impersonate="chrome") # default
API Coverage
| Endpoint | Method | Client Method |
|---|---|---|
GET /api/v1/persons |
Search/filter persons | search_persons() |
GET /api/v1/persons/:slug |
Person detail | get_person() |
GET /api/v1/documents |
Search documents (FTS5) | search_documents() |
GET /api/v1/flights |
Search flight logs | search_flights() |
GET /api/v1/search |
Cross-type search | search() |
Rate Limits
The upstream API enforces per-IP rate limits using a sliding window:
| Endpoints | Limit |
|---|---|
/persons, /persons/:slug, /documents, /flights |
60 requests / minute |
/search |
30 requests / minute |
Exceeding the limit returns HTTP 429 and raises EpsteinExposedRateLimitError.
Response Models
All responses are parsed into typed Pydantic models:
PaginatedResponse[Person],PaginatedResponse[Document],PaginatedResponse[Flight]PersonDetail(extended person with bio, aliases, black book status)SearchResults(documents + emails)PaginationMeta(total, page, per_page, timestamp)
Error Handling
from epsteinexposed import EpsteinExposed, EpsteinExposedRateLimitError
client = EpsteinExposed()
try:
client.search_persons(q="test")
except EpsteinExposedRateLimitError:
print("Rate limited — back off and retry")
| Exception | HTTP Code |
|---|---|
EpsteinExposedValidationError |
400 |
EpsteinExposedNotFoundError |
404 |
EpsteinExposedRateLimitError |
429 |
EpsteinExposedServerError |
5xx |
EpsteinExposedAPIError |
(base) |
Development
git clone https://github.com/guilyx/epsteinexposed.git
cd epsteinexposed
make install-dev
make test # unit tests (mocked)
make lint
Run integration tests against the real API (rate-limit aware):
pytest -m integration --no-cov
Documentation
Full docs at guilyx.github.io/epsteinexposed — built with Vite + React + Tailwind CSS. Run locally with make docs.
License
MIT — see LICENSE.
Metadata
Release files for epsteinexposed 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| epsteinexposed-0.2.0.tar.gz | 14.7 kB | With provenance | Details for epsteinexposed-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| epsteinexposed-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for epsteinexposed-0.2.0-py3-none-any.whl |
Total release size: 27.1 kB
Release files / epsteinexposed-0.2.0.tar.gz
| Download URL | epsteinexposed-0.2.0.tar.gz |
|---|---|
| Size | 14.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
26ae28085ea072a17c6e433d42dd5769205b5d78212577d67949f34375e17824
|
|
BLAKE2b-256 checksum How to use checksums |
6b1b2c547cb612d83a5d7d4e80598ac8255256ed2a83c21ba5c48d6769c72700
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 23, 2026.
Transparency logRelease files / epsteinexposed-0.2.0-py3-none-any.whl
| Download URL | epsteinexposed-0.2.0-py3-none-any.whl |
|---|---|
| Size | 12.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6ab5f622ed649acd676e47ef3485a7f93703a8523de26b7a036f539862483cf2
|
|
BLAKE2b-256 checksum How to use checksums |
e3c22ba6b4d8a6d1607e3460d9133a01611a01dad25400fbb32f57de4e8fb524
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 23, 2026.
Transparency logSecurity for epsteinexposed 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for epsteinexposed-0.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 23, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.