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/search
Search for skills from the database.

Query Parameters

ParamTypeDefaultDescription
qstring-Search query for title, description, or author.
pagenumber1Page number for pagination.
limitnumber20Items per page (max 100).
sortBystringrecentSort 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 } } }