API-Dokumentation

Greifen Sie programmatisch auf SkillsMP Skills-Daten über unsere REST-API zu. Unterstützt Stichwortsuche sowie Filter nach Kategorie, Beruf und erkannter Inhaltssprache der Skills.

table_of_contents.md

Authentifizierung

Endpunkte

GET /api/v1/skills/search

Skills nach Stichwörtern durchsuchen

Parameter	Typ	Erforderlich	Beschreibung
q	string	✓	Suchanfrage
page	number	-	Seitennummer (Standard: 1)
limit	number	-	Elemente pro Seite (Standard: 20, Max: 100)
sortBy	string	-	Sortierung: stars \| recent (Standard: recent)
category	string	-	Nach Kategorie-Slug filtern (z. B. data-ai, devops).
occupation	string	-	Nach SOC-Berufs-Slug filtern (z. B. software-developers).
language	string	-	Nach der erkannten Inhaltssprache des Skills filtern. ISO-Sprachcodes wie en, zh oder ja verwenden; mul steht für gemischte Sprachen und und für nicht bestimmbare Inhalte.

Ratenbegrenzungen

*Anonym (ohne API-Schlüssel): 50 Anfragen/Tag, 10/Min — nur Stichwortsuche
*Authentifiziert (mit API-Schlüssel): 500 Anfragen/Tag, 30/Min — Stichwortsuche
*Platzhaltersuchen (z.B. *) werden nicht unterstützt

Jede API-Antwort enthält die folgenden Header zur Nachverfolgung Ihrer Kontingentnutzung:

Header	Beschreibung
X-RateLimit-Daily-Limit	Tägliches Anfragelimit
X-RateLimit-Daily-Remaining	Verbleibende Anfragen für heute

Codebeispiele

Stichwortsuche

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

Suche mit Berufsfilter

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"

Fehlerbehandlung

Die API verwendet standardmäßige HTTP-Statuscodes und gibt Fehlerdetails im JSON-Format zurück.

Fehlercode	HTTP	Beschreibung
INVALID_API_KEY	401	Ungültiger API-Schlüssel
MISSING_QUERY	400	Erforderlicher Abfrageparameter fehlt
INVALID_OCCUPATION	400	Unbekannter Berufs-Slug
INVALID_LANGUAGE	400	Unbekannter Code für die Inhaltssprache
DAILY_QUOTA_EXCEEDED	429	Tägliches API-Kontingent überschritten
INTERNAL_ERROR	500	Interner Serverfehler

Fehlerantwort-Beispiel:

json

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

more.md

Zurück zur Dokumentation