Skip to main content

epsteinexposed

Credits: Erwin Lejeune — 2026-02-22

CI Codacy Badge codecov PyPI PyPI - Downloads Python PyPI - Format License: MIT Docs

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)

Source distribution for epsteinexposed 0.2.0
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)

Table of built distributions (wheels) for epsteinexposed 0.2.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page