https://devdirectory.com/api/v1
All endpoints return JSON with a success boolean. No API key required for public read endpoints.
/api/v1/tools
Returns a paginated, filtered, sorted list of published tools.
| Param | Type | Default | Description |
|---|---|---|---|
| search | string | "" | Full-text search across name, description, tags |
| category | string | "" | Comma-separated category names |
| pricing | string | "" | Comma-separated pricing groups |
| api | string | "" | Comma-separated API types (REST API, GraphQL, etc.) |
| sort | string | featured | featured | newest | az | rating |
| page | int | 1 | Page number |
| limit | int | 6 | Items per page (max 100) |
curl "https://devdirectory.com/api/v1/tools?search=docker&sort=rating&limit=5"/api/v1/tools/{slug}
Returns full details for a single tool including features, specs, code snippets, and alternatives.
curl "https://devdirectory.com/api/v1/tools/playwright"/api/v1/tools/{slug}/alternatives
Returns similar tools in the same category + explicitly listed alternatives.
curl "https://devdirectory.com/api/v1/tools/playwright/alternatives"/api/v1/trending
Returns tools ranked by a trending score (recent clicks, reviews, upvotes, featured status).
| Param | Type | Default | Description |
|---|---|---|---|
| limit | int | 10 | Number of tools (max 50) |
| days | int | 7 | Activity window in days |
curl "https://devdirectory.com/api/v1/trending?limit=5&days=7"/api/v1/compare?slugs=playwright,browser-use
Returns full details for 2-4 tools for side-by-side comparison.
curl "https://devdirectory.com/api/v1/compare?slugs=cursor,github-copilot,continue"/api/v1/search?q=docker
Lightweight endpoint for instant search autocomplete. Returns up to 8 suggestions.
curl "https://devdirectory.com/api/v1/search?q=docker"/api/v1/collections
Returns curated tool collections (e.g., "Best AI Coding Tools for 2026"). Use ?id=collection-id to get tools in a specific collection.
curl "https://devdirectory.com/api/v1/collections"
curl "https://devdirectory.com/api/v1/collections?id=best-ai-coding-tools-2026"/api/v1/votes/{slug}?userId=xxx
Returns the tool's upvote count and whether the user has voted.
/api/v1/votes/{slug}
Body: { "userId": "fp_xxxxxxxx" } — toggles a vote (add/remove). One vote per user per tool.
/api/v1/reviews/{slug}
Returns community reviews for a tool.
/api/v1/reviews/{slug}
Body: { "userId": "xxx", "userName": "Jane", "rating": 5, "title": "Great!", "body": "..." }
/api/v1/tools/submit
Submit a new tool for review. Requires CAPTCHA token + email for confirmation.
/api/v1/newsletter/subscribe
Body: { "email": "user@example.com", "source": "footer" } — triggers double opt-in email.
| Endpoint | Limit | Window |
|---|---|---|
| /api/v1/tools (search) | 100 requests | per minute per IP |
| /api/v1/tools/submit | 3 requests | per hour per IP |
| /api/v1/votes | 60 requests | per minute per IP |
| /api/v1/newsletter/subscribe | 5 requests | per hour per IP |
/rss.xml
RSS 2.0 feed of the 20 newest published tools. Subscribe in any RSS reader.
https://devdirectory.com/rss.xml