Skip to content

Commit 0d07484

Browse files
idoshamunclaudegithub-actions[bot]
authored
docs: add Public API documentation for Plus subscribers (#497)
## Summary - Add comprehensive documentation for the daily.dev Public API, a REST API that enables AI agents and automation tools to access personalized developer content - Document authentication with Personal Access Tokens, available endpoints (feeds, posts, search, bookmarks, custom feeds, filters, notifications, profile, tech stack), rate limiting, and response formats - Include AI agent integration instructions for Claude Code and OpenClaw - Add Public API section to the Plus Overview page ## Key Decisions - Placed the docs in `docs/plus/` since the Public API is a Plus-exclusive feature - Linked to OpenAPI spec (JSON/YAML) for complete endpoint details rather than duplicating all schemas - Focused on practical use cases (AI agents, automation) rather than low-level API reference Closes ENG-602 --- Created by Huginn 🐦‍⬛ --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Ido Shamun <idoshamun@users.noreply.github.com>
1 parent 7f797de commit 0d07484

File tree

4 files changed

+235
-0
lines changed

4 files changed

+235
-0
lines changed

‎CLAUDE.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,7 @@ The documentation is organized into main categories:
6868
- Create `.md` files in appropriate `docs/` subdirectories
6969
- Use `_category_.json` files to configure category metadata
7070
- Sidebar is auto-generated from folder structure
71+
- **IMPORTANT**: When adding new feature documentation, also update the homepage navigation in `src/components/homepage/homeNavBoxes.js` to add a link to the new feature in the appropriate section (e.g., Plus, Key features, etc.)
7172

7273
### Component Development
7374
- Homepage components are in `src/components/homepage/`

‎docs/plus/plus-overview.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,16 @@ Mute the buzzwords and topics you don’t care about. Customize your feed by aut
9393

9494
👉 [Set up your keyword filters](plus/keyword-filters.md)
9595

96+
### Public API - Build with daily.dev
97+
98+
Access your daily.dev content programmatically. Integrate with AI coding assistants like Claude Code, build automation workflows, or create custom integrations with your personalized feed.
99+
100+
- Connect AI agents to real-time developer content
101+
- Build custom workflows with your feeds and bookmarks
102+
- Integrate with Claude Code and OpenClaw out of the box
103+
104+
👉 [Explore the Public API](plus/public-api.md)
105+
96106
### Auto-translate your feed (coming soon)
97107

98108
Read in your preferred language with automatic translations for post titles and summaries, making it easier to access global knowledge.

‎docs/plus/public-api.md‎

Lines changed: 223 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,223 @@
1+
---
2+
sidebar_position: 7
3+
description: "Access your daily.dev feed programmatically with the Public API. Build integrations with AI coding assistants, automate workflows, and access personalized developer content via REST API."
4+
---
5+
6+
# Public API
7+
8+
The daily.dev Public API is a REST API that enables AI agents, automation tools, and custom integrations to access personalized developer content. Whether you're building with Claude Code, OpenClaw, or creating your own integration, the API provides programmatic access to your feeds, bookmarks, posts, and more.
9+
10+
:::info Plus Required
11+
The Public API requires an active [Plus subscription](https://app.daily.dev/plus).
12+
:::
13+
14+
## Getting Started
15+
16+
### Generate a Personal Access Token
17+
18+
1. Go to [API Settings](https://app.daily.dev/settings/api)
19+
2. Click "Generate new token"
20+
3. Give your token a descriptive name (e.g., "My AI Agent")
21+
4. Choose an expiration period (never, 30 days, 90 days, or 1 year)
22+
5. Copy and securely store your token - it will only be shown once
23+
24+
### Security Best Practices
25+
26+
- Never commit tokens to version control
27+
- Store tokens in environment variables or secure vaults
28+
- Revoke tokens you no longer need from the settings page
29+
30+
## Authentication
31+
32+
All API requests require Bearer token authentication.
33+
34+
**Header format:**
35+
36+
```
37+
Authorization: Bearer <your-token>
38+
```
39+
40+
**Example request:**
41+
42+
```bash
43+
curl -H "Authorization: Bearer your-token-here" \
44+
https://api.daily.dev/public/v1/feeds
45+
```
46+
47+
**Error responses:**
48+
49+
- `401 Unauthorized` - Missing or invalid token
50+
51+
## Base URL & API Reference
52+
53+
- **Base URL:** `https://api.daily.dev/public/v1`
54+
- **OpenAPI Specification (JSON):** [https://api.daily.dev/public/v1/docs/json](https://api.daily.dev/public/v1/docs/json)
55+
- **OpenAPI Specification (YAML):** [https://api.daily.dev/public/v1/docs/yaml](https://api.daily.dev/public/v1/docs/yaml)
56+
57+
The OpenAPI spec provides complete endpoint documentation including request/response schemas, and can be imported into tools like Postman or used to generate client libraries.
58+
59+
## Available Endpoints
60+
61+
### Feeds
62+
63+
Access your personalized content streams. Get your "For You" feed tailored to your interests, browse popular posts across the platform, discover content by specific tags or sources, or see what's generating the most discussion in the community.
64+
65+
- Get your personalized "For You" feed
66+
- Browse trending and popular posts
67+
- Filter content by tags or sources
68+
- View most discussed posts
69+
70+
### Posts
71+
72+
Dive deeper into individual articles. Retrieve full details about any post including its summary, engagement metrics, and metadata. Access the discussion by fetching comments and replies.
73+
74+
- Get detailed information about any post
75+
- Fetch comments and discussions
76+
77+
### Search
78+
79+
Find exactly what you're looking for. Search across posts to discover articles on specific topics, find tags to follow, or discover new content sources to add to your feed.
80+
81+
- Search posts by keywords
82+
- Find tags matching your query
83+
- Discover content sources
84+
85+
### Bookmarks
86+
87+
Access your saved content library. Retrieve bookmarks you've saved, search through them, and organize them into folders for easy access later.
88+
89+
- List your saved bookmarks
90+
- Search within your bookmarks
91+
- Manage bookmark folders (create, list, delete)
92+
- Add or remove bookmarks programmatically
93+
94+
### Custom Feeds
95+
96+
Build laser-focused content streams for specific topics or workflows. Create custom feeds with specific filters, set engagement thresholds, and configure advanced content settings to surface exactly the content you need.
97+
98+
- List and view your custom feeds
99+
- Create new custom feeds with specific criteria
100+
- Update or delete existing feeds
101+
- Configure advanced settings like minimum upvotes or view counts
102+
103+
### Feed Filters
104+
105+
Fine-tune what appears in your feeds. Manage the tags, sources, and content types that appear in your personalized or custom feeds. Add or remove filters to shape your content experience.
106+
107+
- View current filter settings
108+
- Add tags or sources to follow
109+
- Block unwanted tags or sources
110+
- Apply filters to specific feeds or globally
111+
112+
### Notifications
113+
114+
Stay on top of your daily.dev activity. Access your notification feed, check unread counts, and mark notifications as read.
115+
116+
- List your notifications
117+
- Get unread notification count
118+
- Mark notifications as read
119+
120+
### Profile
121+
122+
Access and update your daily.dev profile information programmatically.
123+
124+
- Get your profile details
125+
- Update profile information
126+
127+
### Tech Stack
128+
129+
Showcase the tools you use. Manage your technology stack that appears on your profile - add tools, update descriptions, reorder items, and search for tools to add.
130+
131+
- View your current tech stack
132+
- Add new tools to your stack
133+
- Update or remove existing items
134+
- Search available tools
135+
- Reorder your stack display
136+
137+
For complete endpoint details, parameters, and response schemas, see the [OpenAPI specification](https://api.daily.dev/public/v1/docs/json).
138+
139+
## Rate Limiting
140+
141+
The API implements two layers of rate limiting:
142+
143+
| Limit Type | Rate | Purpose |
144+
| --- | --- | --- |
145+
| IP-based | 300 requests/minute | Protection against abuse |
146+
| User-based | 60 requests/minute | Fair usage quota |
147+
148+
**Rate limit headers in responses:**
149+
150+
- `x-ratelimit-limit` - Your rate limit ceiling
151+
- `x-ratelimit-remaining` - Requests remaining in current window
152+
- `x-ratelimit-reset` - When the rate limit resets
153+
154+
**When rate limited (HTTP 429):**
155+
156+
- `retry-after` header indicates seconds to wait
157+
- Back off and retry after the indicated time
158+
159+
## Response Format
160+
161+
All responses use JSON with a consistent structure.
162+
163+
**Paginated responses:**
164+
165+
```json
166+
{
167+
"data": [...],
168+
"pagination": {
169+
"hasNextPage": true,
170+
"endCursor": "cursor-string"
171+
}
172+
}
173+
```
174+
175+
**Pagination:** Use cursor-based pagination by passing the `endCursor` value as the `cursor` parameter in subsequent requests.
176+
177+
## AI Agent Integrations
178+
179+
### Claude Code
180+
181+
Add daily.dev to Claude Code as a plugin with these commands:
182+
183+
```bash
184+
claude plugin marketplace add https://github.com/dailydotdev/daily.git
185+
claude plugin install daily.dev@daily.dev
186+
claude "/daily.dev setup"
187+
```
188+
189+
After installation, use the `/daily.dev` skill to interact with your daily.dev feed and other features.
190+
191+
### OpenClaw
192+
193+
Copy this instruction to your agent to get started:
194+
195+
```
196+
Install the daily-dev skill from clawdhub and explain my new superpowers
197+
```
198+
199+
The skill is available on ClawHub at [https://clawhub.ai/idoshamun/daily-dev](https://clawhub.ai/idoshamun/daily-dev)
200+
201+
### Direct API Integration
202+
203+
For custom integrations, use the OpenAPI specification to generate client libraries or make direct HTTP requests. The specification is available at:
204+
205+
- JSON: [https://api.daily.dev/public/v1/docs/json](https://api.daily.dev/public/v1/docs/json)
206+
- YAML: [https://api.daily.dev/public/v1/docs/yaml](https://api.daily.dev/public/v1/docs/yaml)
207+
208+
## Example: Fetching Your Feed
209+
210+
```bash
211+
# Get your personalized feed
212+
curl -H "Authorization: Bearer $DAILY_DEV_TOKEN" \
213+
"https://api.daily.dev/public/v1/feeds"
214+
215+
# Get the next page using cursor
216+
curl -H "Authorization: Bearer $DAILY_DEV_TOKEN" \
217+
"https://api.daily.dev/public/v1/feeds?cursor=cursor-from-previous-response"
218+
```
219+
220+
## Related Documentation
221+
222+
- [Plus Overview](plus-overview.md) - Learn about all Plus features
223+
- [Custom Feeds](custom-feeds.md) - Create feeds to access via API

‎src/components/homepage/homeNavBoxes.js‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,7 @@ const FeatureList = [
9595
icon: 'img/icons/plus.svg',
9696
items: [
9797
{ url: 'docs/plus/plus-overview', text: 'Overview' },
98+
{ url: 'docs/plus/public-api', text: 'Public API' },
9899
{ url: 'docs/plus/presidential-briefing', text: 'Presidential Briefing' },
99100
{ url: 'docs/plus/smart-prompts', text: 'Smart Prompts' },
100101
{ url: 'docs/plus/custom-feeds', text: 'Advanced Custom Feeds' },

0 commit comments

Comments
 (0)