API.md
REST API
# API Documentation
Access SkillsMP Skills data programmatically through our REST API. Support keyword search and AI semantic search.
table_of_contents.md
Authentication
Endpoints
GET /api/v1/skills/search
Search skills using keywords
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | โ | Search query |
| page | number | - | Page number (default: 1) |
| limit | number | - | Items per page (default: 20, max: 100) |
| sortBy | string | - | Sort: stars | recent |
GET /api/v1/skills/ai-search
AI semantic search powered by Cloudflare AI
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | โ | AI search query |
Code Examples
Keyword Search
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
-H "Authorization: Bearer sk_live_your_api_key"AI Semantic Search
curl -X GET "https://skillsmp.com/api/v1/skills/ai-search?q=How+to+create+a+web+scraper" \
-H "Authorization: Bearer sk_live_your_api_key"Error Handling
The API uses standard HTTP status codes and returns error details in JSON format.
| Error Code | HTTP | Description |
|---|---|---|
| MISSING_API_KEY | 401 | API key not provided |
| INVALID_API_KEY | 401 | Invalid API key |
| MISSING_QUERY | 400 | Missing required query parameter |
| INTERNAL_ERROR | 500 | Internal server error |
Error Response Example:
json
{
"success": false,
"error": {
"code": "INVALID_API_KEY",
"message": "The provided API key is invalid"
}
}more.md