Documentación de API

Accede a los datos de SkillsMP Skills programáticamente a través de nuestra API REST. Soporta búsqueda por palabras clave y filtros de categoría y profesión.

table_of_contents.md

Autenticación

Puntos de acceso

GET /api/v1/skills/search

Buscar skills por palabras clave

Parámetro	Tipo	Requerido	Descripción
q	string	✓	Consulta de búsqueda
page	number	-	Número de página (predeterminado: 1)
limit	number	-	Elementos por página (predeterminado: 20, máx: 100)
sortBy	string	-	Ordenar: stars \| recent
category	string	-	Filter by category slug (e.g. data-ai, devops).
occupation	string	-	Filter by SOC occupation slug (e.g. software-developers).

Límites de tasa

*Anónimo (sin clave API): 50 solicitudes/día, 10/min — solo búsqueda por palabras clave
*Autenticado (con clave API): 500 solicitudes/día, 30/min — búsqueda por palabras clave
*Las búsquedas con comodines (ej. *) no son compatibles

Cada respuesta de la API incluye los siguientes encabezados para ayudarte a rastrear el uso de tu cuota:

Encabezado	Descripción
X-RateLimit-Daily-Limit	Límite diario de solicitudes
X-RateLimit-Daily-Remaining	Solicitudes restantes para hoy

Ejemplos de código

Búsqueda por palabras clave

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"

Manejo de errores

La API usa códigos de estado HTTP estándar y devuelve detalles de error en formato JSON.

Código de error	HTTP	Descripción
INVALID_API_KEY	401	Clave API inválida
MISSING_QUERY	400	Parámetro de consulta requerido faltante
INVALID_OCCUPATION	400	Slug de ocupación desconocido
DAILY_QUOTA_EXCEEDED	429	Cuota diaria de API excedida
INTERNAL_ERROR	500	Error interno del servidor

Ejemplo de respuesta de error:

json

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

more.md

Volver a la documentación