# Reletter API

> The newsletter data API. Search 6M+ email newsletters, fetch metadata, contacts, social accounts and rankings, and search the full text of newsletter issues. Built for integration with apps and AI agents.

Reletter provides a REST API for accessing structured newsletter data. The API is designed for integration with your apps and AI agents.

We also provide this as an MCP server at `https://mcp.reletter.com`, and as an official Python SDK and `reletter` CLI (`pip install reletter`).

## Documentation

- [Complete API reference (Markdown)](/llms-full.txt): Full endpoint documentation optimized for LLM consumption.
- [Developer portal](/developers): Human-readable documentation with examples, pricing, and signup.
- [Python client on GitHub](https://github.com/getreletter/reletter-python): Official Python SDK and `reletter` CLI. Typed wrapper around every endpoint, sync and async. `pip install reletter` (or `pipx install reletter` for CLI-only use).
- [MCP server on GitHub](https://github.com/getreletter/reletter-mcp): Remote MCP server at `https://mcp.reletter.com` for Claude, ChatGPT, Cursor, etc.

## Authentication

All endpoints require the `x-reletter-api-key` header containing your API key. You can find your key on your [account settings page](/account/settings) once you have an active subscription with the API add-on.

Base URL: `https://api.reletter.com`

## Quotas and limits

- Default quota: 10,000 requests per calendar month, resets on the 1st of the month.
- Hourly burst limit: 2,000 requests per hour per team. The API returns HTTP 429 if you exceed it.
- Need higher limits? Email support@reletter.com.

## Available endpoints

- `GET /api/search/publications/` — Search newsletters by topic, title or author with advanced filters.
- `GET /api/search/issues/` — Full-text search across newsletter issue bodies.
- `GET /api/search/autocomplete/` — Autocomplete suggestions for type-ahead UIs.
- `GET /api/publications/<publication_id>/` — Full metadata for a publication.
- `GET /api/issues/?publication_id=<id>` — List recent issues for a publication.
- `GET /api/issues/<issue_id>/` — Get a single issue with body text.
- `GET /api/contacts/?publication_id=<id>` — Email and social contacts for a publication.
- `GET /api/charts/` — Index of chart platforms and categories.
- `GET /api/charts/<platform>/<category>/` — Chart rankings.
- `GET /api/accounts/quota/` — Your current API usage and quota.