API and AI connector
Read-only JSON, no API key, no signup. CORS is open for GET requests. The same data is available to AI assistants through the connector below.
Connect an AI assistant
Add this address as a custom connector (Model Context Protocol) in Claude, ChatGPT or any assistant that supports remote MCP servers:
https://adalmanac.com/mcp
Then ask things like “who started sponsoring AI newsletters this week?”, “where does Granola advertise, and where did it keep buying?”, or “which brands should my newsletter pitch?”. Tools: search, newsletter_sponsors, sponsor_placements, new_sponsors, top_sponsors, search_ads, renewal_leaders, list_topics, topic_overview and sponsor_report.
Endpoints
| Endpoint | Returns |
|---|---|
GET /api/v1/newsletters/{slug} | Sponsor placements for one newsletter. |
GET /api/v1/sponsors/{domain} | Newsletters one sponsor advertises in. |
GET /api/v1/new-this-week | Sponsors first seen this week. Pass ?week=YYYY-MM-DD (any Monday) for a past week. |
GET /api/v1/search?q= | Newsletters and sponsors matching a name or domain. |
GET /api/v1/new-sponsors?week=&topic= | Brands that sponsored a newsletter for the first time that week, optionally in one topic. |
GET /api/v1/ads?q=&topic=&offer=&sponsor=&newsletter= | The ad library: each ad's headline, sponsor, newsletter, date, slot and offer. |
GET /api/v1/topics | Topics, with newsletters and active sponsors in each. |
GET /api/v1/topics/{name} | One topic: new buyers, biggest buyers, busiest newsletters, renewal leaders. |
GET /api/v1/top-sponsors?month=YYYY-MM | The monthly ranking of brands by newsletters sponsored. |
GET /api/v1/renewals?topic= | Newsletters ranked by how many sponsors came back. |
GET /api/v1/report/{newsletter} | A newsletter's sponsor report: standing, brands to pitch, former sponsors buying elsewhere. |
Example
curl https://adalmanac.com/api/v1/newsletters/tldr curl "https://adalmanac.com/api/v1/ads?topic=AI&offer=free%20trial"
Rate limit
120 requests per 60 seconds, per IP address. Exceeding it returns HTTP 429.