API Reference
Documentation for the Skills Blog Public API.
Authentication
All API requests require authentication using an API Key. You can pass the key in two ways:
- Header:
Authorization: Bearer YOUR_API_KEY - Header:
x-api-key: YOUR_API_KEY
Rate Limits
The API is rate-limited to ensure fair usage.
Limit: 60 requests / minute
Burst: 1 request / second
Endpoints
GET
/api/v1/skillsblog/searchSearch for skills from the database.
Query Parameters
| Param | Type | Default | Description |
|---|---|---|---|
| q | string | - | Search query for title, description, or author. |
| page | number | 1 | Page number for pagination. |
| limit | number | 20 | Items per page (max 100). |
| sortBy | string | recent | Sort order: "recent" or "stars". |
Response Example
{
"success": true,
"data": {
"skills": [
{
"id": "cl...",
"title": "Example Skill",
"description": "A powerful AI skill...",
"author": "johndoe",
"stars": 120,
"url": "https://skillsblog.com/skill/..."
...
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 150,
"totalPages": 8
}
}
}