SkillsMP API

https://skillsmp.com/docs/api
Admin
SkillsMP REST API for searching Agent Skills by keyword, category, occupation, and content language,...
Tokens:2,536
Snippets:27
Trust Score:6.9
Update:1 week ago
Show doc for...
Tokens:
Raw
### JSON: Error response example

Source: https://skillsmp.com/docs/api

Example error response returned by the API when an invalid API key is provided. The response includes a success flag and an error object with code and message.

```json
{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid"
  }
}
```

--------------------------------

### GET /api/v1/skills/search

Source: https://skillsmp.com/docs/api

Search skills using keywords. Supports keyword search plus category, occupation, and detected Skill content-language filters.

```APIDOC
## GET /api/v1/skills/search

### Description
Search skills using keywords. Supports keyword search plus category, occupation, and detected Skill content-language filters.

### Method
GET

### Endpoint
/api/v1/skills/search

### Parameters
#### Query Parameters
- **q** (string) - Required - Search query
- **page** (number) - Optional - Page number (default: 1)
- **limit** (number) - Optional - Items per page (default: 20; maximum: 50)
- **sortBy** (string) - Optional - Sort order: stars | recent (default: stars)
- **category** (string) - Optional - Filter by category slug (e.g. data-ai, devops). Browse values
- **occupation** (string) - Optional - Filter by SOC occupation slug (e.g. software-developers). Browse values
- **language** (string) - Optional - Filter by detected Skill content language. Use an ISO code such as en, zh, or ja; mul selects mixed-language content and und selects undetermined content.

### Request Example
```
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
  -H "Authorization: Bearer sk_live_your_api_key"
```

### Response
#### Success Response (200)
No response schema provided in the source.

#### Response Example
No response example provided in the source.

### Error Handling
The API uses standard HTTP status codes and returns error details in JSON format.

| Error Code | HTTP | Description |
|---|---|---|
| INVALID_API_KEY | 401 | Invalid API key |
| MISSING_QUERY | 400 | Missing required query parameter |
| INVALID_OCCUPATION | 400 | Unknown occupation slug |
| INVALID_LANGUAGE | 400 | Unknown content language code |
| DAILY_QUOTA_EXCEEDED | 429 | Daily API quota exceeded |
| INTERNAL_ERROR | 500 | Internal server error |

#### Error Response Example
```
{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid"
  }
}
```

### Rate Limits
- Anonymous (no API key): 50 requests/day, 10 requests/min — keyword search only
- Authenticated (with API key): 500 requests/day, 30 requests/min — keyword search
- Wildcard searches (e.g. *) are not supported

### Response Headers
When present, these REST search response headers report daily quota usage:

| Header | Description |
|---|---|
| X-RateLimit-Daily-Limit | Your daily request limit |
| X-RateLimit-Daily-Remaining | Remaining requests for today |
```

--------------------------------

### cURL: Search skills with keyword 'SEO'

Source: https://skillsmp.com/docs/api

Basic keyword search using the q parameter. Requires an API key sent as a Bearer token in the Authorization header.

```bash
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
  -H "Authorization: Bearer sk_live_your_api_key"
```

--------------------------------

### cURL: Search with filters (occupation, language, sortBy)

Source: https://skillsmp.com/docs/api

Search with additional filters: occupation slug, language code, and sort order. Requires an API key.

```bash
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=automation&occupation=software-developers&language=zh&sortBy=stars" \
  -H "Authorization: Bearer sk_live_your_api_key"
```
Tokens:
Raw