API
Public and operational endpoints for the Developers Digest platform. Most read endpoints require no authentication, while course chat and protected sync endpoints use Clerk or bearer-token auth.
GET
/api/toolsList all tools in the directory with optional filtering.
Parameters
categorystringFilter by category (e.g., AI Coding)qstringSearch tools by name, description, or tagsResponse:
{ "tools": [...], "total": 64 }Cache: 1 hourAuth: NoneGET
/api/search-indexFull search index with all blog posts, guides, tools, videos, courses, and toolkit pages.
Response:
[{ "type": "blog", "title": "...", "description": ...Cache: 1 minute + 5 min stale-while-revalidateAuth: NoneGET
/api/search.jsonServer-side search over the full site index, ranked with the same Fuse.js config as the on-site search.
Parameters
qstringSearch query (required, min 2 characters)typestringFilter by result type (blog, guide, tool, video, course, toolkit, page, app)limitnumberMax results, 1-50 (default 20)Response:
{ "query": "claude code", "count": 20, "results": ...Cache: 5 minutes + 1 hour stale-while-revalidateAuth: NoneGET
/api/sitemap.jsonJSON mirror of sitemap.xml with URL, lastModified, changeFrequency, and priority per entry.
Response:
{ "generatedAt": "...", "count": 900, "entries": [...Cache: 1 hour + 24 hour stale-while-revalidateAuth: NoneGET
/api/healthHealth check with content counts, required environment status, and optional integration visibility.
Response:
{ "status": "healthy", "environment": "production"...Cache: NoneAuth: NoneGET
/api/health/deepDeep health check with version info, git SHA, build time, dependency audit, runtime metrics, and content inventory.
Response:
{ "status": "healthy", "version": { "app": "0.1.0"...Cache: NoneAuth: NonePOST
/api/semantic-searchEmbedding-backed semantic search over generated content embeddings.
Parameters
qstringSearch query (minimum 2 characters)Response:
{ "results": [{ "title": "...", "url": "/blog/..."...Cache: 1 minute + 5 min stale-while-revalidateAuth: NoneGET
/api/sync-videosProtected video coverage and sync status endpoint used for scheduled operations and manual checks.
Response:
{ "timestamp": "...", "totalVideos": 123, "stats":...Cache: 1 hour + 2 hours stale-while-revalidateAuth: Bearer CRON_SECRET when configuredPOST
/api/chatAuthenticated AI companion endpoint for signed-in users studying Developers Digest courses.
Response:
UI message stream responseCache: NoneAuth: Signed-in Clerk session requiredGET
/api/ogGenerate dynamic Open Graph images with custom title and subtitle.
Parameters
titlestringMain heading textsubtitlestringSubtitle text (optional)Response:
1200x630 PNG imageCache: Edge cachedAuth: NoneGET
/feed.xmlRSS 2.0 feed with all blog posts, guides, and videos.
Response:
application/rss+xmlCache: 1 hourAuth: NoneGET
/atom.xmlAtom 1.0 feed with all blog posts, guides, and videos.
Response:
application/atom+xmlCache: 1 hourAuth: NoneGET
/feed.jsonJSON Feed 1.1 with all blog posts.
Response:
application/feed+jsonCache: 1 hourAuth: NoneGET
/blog/tags/[tag]/feed.xmlPer-tag RSS feed for blog posts.
Parameters
tagpathTag slug (e.g., claude-code)Response:
application/rss+xmlCache: 1 hourAuth: NoneGET
/api/random/postReturns a random blog post. Useful for discovery widgets and shuffle features.
Response:
{ "site": "Developers Digest", "generatedAt": "......Cache: None (always fresh)Auth: NoneGET
/api/random/toolReturns a random tool from the directory. Useful for discovery widgets and recommendations.
Response:
{ "site": "Developers Digest", "generatedAt": "......Cache: None (always fresh)Auth: None
Get Smarter About AI Dev
New tutorials, open-source projects, and deep dives on coding agents - delivered weekly.
One email per weekReal code, not theoryFree forever