APIドキュメント

REST APIを通じてSkillsMP Skillsデータにプログラムからアクセス。キーワード検索と、カテゴリ、職業、検出されたSkillのコンテンツ言語によるフィルターをサポートします。

table_of_contents.md

認証

エンドポイント

GET /api/v1/skills/search

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

パラメータ	型	必須	説明
q	string	✓	検索クエリ
page	number	-	ページ番号（デフォルト: 1）
limit	number	-	1ページあたりの件数（デフォルト: 20、最大: 100）
sortBy	string	-	並び順: stars \| recent（デフォルト: recent）
category	string	-	カテゴリ slug で絞り込みます（例: data-ai、devops）。
occupation	string	-	SOC 職業 slug で絞り込みます（例: software-developers）。
language	string	-	Skill 本文の検出言語で絞り込みます。en、zh、ja などの ISO 言語コードを使用し、mul は混合言語、und は判定不能を表します。

レート制限

*匿名アクセス（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"

職業フィルターを使った検索

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"

エラーハンドリング

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

エラーコード	HTTP	説明
INVALID_API_KEY	401	無効なAPIキー
MISSING_QUERY	400	必須のクエリパラメータがありません
INVALID_OCCUPATION	400	不明な職業 slug
INVALID_LANGUAGE	400	不明なコンテンツ言語コード
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

ドキュメントに戻る