The Blogtrottr API is now out of beta, available on Lite and Full plans. Hook it up to scripts, pull it into other tools, or just manage your subscriptions without touching the dashboard.
What you can do
Subscriptions, categories, and delivery addresses are all available via the API - including email and webhook delivery, filters, and more.
Subscriptions
- List your subscriptions, with optional filters for feed URL, schedule, output type, category, or enabled status
- Create a new subscription - specify a feed URL, delivery schedule, output format, filters, and more
- Update an existing subscription - toggle it on or off, change the schedule, adjust delivery settings
- Delete a subscription
Categories
- List, create, update, and delete categories - including setting keyword filters on a category
Delivery addresses
- List your additional delivery addresses (extra inboxes you've added to receive subscription emails), or retrieve a specific one by ID
Getting started
Generate an API token from your Account settings, API tokens page, then include it as a Bearer token with each request:
Authorization: Bearer YOUR_TOKEN
Here's the simplest possible request - fetching all your subscriptions:
curl https://blogtrottr.com/api/subscriptions \
-H "Authorization: Bearer YOUR_TOKEN"
The response is a paginated JSON list of your subscriptions.
{
"data": [
{
"id": "aabbccddeeff001122334455",
"enabled": true,
"url": "https://example.com/feed.rss",
"schedule": "asap",
"output": "email",
"digest_sort": null,
"from": null,
"subject_format": null,
"title_only": false,
"user_title": null,
"filter": { "version": 2, "enabled": false, ... },
"email_address_id": null,
"created_at": "2024-01-15T10:30:00.000000Z",
"updated_at": "2024-01-15T10:30:00.000000Z"
}
],
"links": { ... },
"meta": { ... }
}
The full API documentation - including request and response formats, field references, and an OpenAPI spec - is available at blogtrottr.com/help/api.