APIドキュメント

REST APIを通じてSkillsMP Skillsデータにプログラムからアクセス。キーワード検索、カテゴリ、職業フィルターをサポートします。

table_of_contents.md

認証

エンドポイント

GET /api/v1/skills/search

キーワードでスキルを検索

パラメータ	型	必須	説明
q	string	✓	検索クエリ
page	number	-	ページ番号（デフォルト: 1）
limit	number	-	1ページあたりの件数（デフォルト: 20、最大: 100）
sortBy	string	-	ソート: stars \| recent
category	string	-	Filter by category slug (e.g. data-ai, devops).
occupation	string	-	Filter by SOC occupation slug (e.g. software-developers).

レート制限

*匿名アクセス（APIキー不要）：50回/日、10回/分 — キーワード検索のみ
*認証済み（APIキー使用）：500回/日、30回/分 — キーワード検索
*ワイルドカード検索（例: *）はサポートされていません

各APIレスポンスにはクォータ使用量を追跡するための以下のヘッダーが含まれます：

ヘッダー	説明
X-RateLimit-Daily-Limit	1日のリクエスト上限
X-RateLimit-Daily-Remaining	本日の残りリクエスト数

コード例

キーワード検索

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

Search with occupation filter

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

エラーハンドリング

APIは標準HTTPステータスコードを使用し、JSON形式でエラー詳細を返します。

エラーコード	HTTP	説明
INVALID_API_KEY	401	無効なAPIキー
MISSING_QUERY	400	必須のクエリパラメータがありません
INVALID_OCCUPATION	400	不明な職業 slug
DAILY_QUOTA_EXCEEDED	429	1日のAPIクォータを超過しました
INTERNAL_ERROR	500	サーバー内部エラー

エラーレスポンス例：

json

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

more.md

ドキュメントに戻る