### Keyword Search API Request (cURL)

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

Example of how to perform a keyword search for skills using cURL. It specifies the API endpoint, query parameters, and includes an authorization header.

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

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

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

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

Search skills using keywords. This endpoint allows you to find skills based on a provided search query.

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

### Description
Search skills using keywords. This endpoint allows you to find skills based on a provided search query.

### 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, max: 100)
- **sortBy** (string) - Optional - Sort: stars | recent

### 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)
- **skills** (array) - List of skills matching the search query
- **total** (number) - Total number of skills found

#### Response Example
```json
{
  "success": true,
  "data": [
    {
      "id": "skill-123",
      "name": "SEO Basics",
      "description": "Learn the fundamentals of Search Engine Optimization.",
      "stars": 150,
      "recent": "2023-10-27T10:00:00Z"
    }
  ],
  "total": 150
}
```
```

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

### GET /api/v1/skills/ai-search

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

AI semantic search powered by Cloudflare AI. This endpoint uses AI to understand the intent behind your query and find relevant skills.

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

### Description
AI semantic search powered by Cloudflare AI. This endpoint uses AI to understand the intent behind your query and find relevant skills.

### Method
GET

### Endpoint
/api/v1/skills/ai-search

### Parameters
#### Query Parameters
- **q** (string) - Required - AI search query

### Request Example
```
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"
```

### Response
#### Success Response (200)
- **skills** (array) - List of skills matching the AI search query
- **total** (number) - Total number of skills found

#### Response Example
```json
{
  "success": true,
  "data": [
    {
      "id": "skill-456",
      "name": "Web Scraping with Python",
      "description": "Learn how to extract data from websites using Python.",
      "stars": 200,
      "recent": "2023-10-26T12:00:00Z"
    }
  ],
  "total": 200
}
```
```

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

### AI Semantic Search API Request (cURL)

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

Example of how to perform an AI semantic search for skills using cURL. It utilizes the AI search endpoint and requires an authorization header.

```shell
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"
```

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

### API Error Response Example

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

Illustrates the structure of an error response from the SkillsMP API. This JSON object contains details about the success status, error code, and a descriptive message.

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

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.