API Documentation

Access SkillWink skills programmatically through REST API with keyword and AI semantic search.

Table of Contents: Authentication · Endpoints · Code Examples · Error Handling

Authentication

Please sign in first to create and manage API keys.

Base URL

/api/v1

Header: Authorization: Bearer sk_live_skillwink_xxx

Endpoints

GET

/api/v1/skills/search

Search skills using keywords

GET

/api/v1/skills/ai-search

AI semantic search powered by lightweight semantic matching

GET /api/v1/skills/search

Parameter	Type	Required	Description
q	string	yes	Search query
page	number	no	Page number (default: 1)
limit	number	no	Items per page (default: 20, max: 100)
sortBy	string	no	Sort: recent \| downloads \| likes \| comments
category	string	no	Filter by category

GET /api/v1/skills/ai-search

Parameter	Type	Required	Description
q	string	yes	AI semantic search query
page	number	no	Page number (default: 1)
limit	number	no	Items per page (default: 20, max: 100)

Code Examples

Keyword Search

curl -X GET "http://www.skillwink.com/api/v1/skills/search?q=design" \
  -H "Authorization: Bearer sk_live_skillwink_your_api_key"

const resp = await fetch("http://www.skillwink.com/api/v1/skills/search?q=design", {
  headers: { Authorization: "Bearer sk_live_skillwink_your_api_key" }
});
const data = await resp.json();

import requests
r = requests.get(
    "http://www.skillwink.com/api/v1/skills/search",
    params={"q": "design"},
    headers={"Authorization": "Bearer sk_live_skillwink_your_api_key"},
    timeout=20,
)
print(r.json())

AI Semantic Search

curl -X GET "http://www.skillwink.com/api/v1/skills/ai-search?q=how+to+write+a+report" \
  -H "Authorization: Bearer sk_live_skillwink_your_api_key"

const resp = await fetch("http://www.skillwink.com/api/v1/skills/ai-search?q=how+to+write+a+report", {
  headers: { Authorization: "Bearer sk_live_skillwink_your_api_key" }
});
const data = await resp.json();

import requests
r = requests.get(
    "http://www.skillwink.com/api/v1/skills/ai-search",
    params={"q": "how to write a report"},
    headers={"Authorization": "Bearer sk_live_skillwink_your_api_key"},
    timeout=20,
)
print(r.json())

Error Handling

The API uses standard HTTP status codes and returns JSON error details.

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
RATE_LIMITED	429	Rate limit exceeded
INTERNAL_ERROR	500	Internal server error

Error Response Example

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key."
  }
}