Documentação da API

Acesse dados do SkillsMP Skills programaticamente pela nossa API REST. Suporta pesquisa por palavras-chave e filtros por categoria e profissão.

table_of_contents.md

Autenticação

Endpoints

GET /api/v1/skills/search

Pesquise skills usando palavras-chave

Parâmetro	Tipo	Obrigatório	Descrição
q	string	✓	Consulta de pesquisa
page	number	-	Número da página (padrão: 1)
limit	number	-	Itens por página (padrão: 20, máximo: 100)
sortBy	string	-	Ordenação: stars \| recent (padrão: recent)
category	string	-	Filtre pelo slug da categoria (ex.: data-ai, devops).
occupation	string	-	Filtre pelo slug da ocupação SOC (ex.: software-developers).

Limites de uso

*Anônimo (sem chave de API): 50 requisições/dia, 10/min — apenas pesquisa por palavras-chave
*Autenticado (com chave de API): 500 requisições/dia, 30/min — pesquisa por palavras-chave
*Pesquisas com curingas (ex.: *) não são suportadas

Toda resposta da API inclui os seguintes headers para ajudar a acompanhar o uso da sua cota:

Header	Descrição
X-RateLimit-Daily-Limit	Seu limite diário de requisições
X-RateLimit-Daily-Remaining	Requisições restantes hoje

Exemplos de código

Pesquisa por palavras-chave

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

Pesquisa com filtro de ocupação

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"

Tratamento de erros

A API usa códigos de status HTTP padrão e retorna detalhes de erro em formato JSON.

Código do erro	HTTP	Descrição
INVALID_API_KEY	401	Chave de API inválida
MISSING_QUERY	400	Parâmetro de consulta obrigatório ausente
INVALID_OCCUPATION	400	Slug de ocupação desconhecido
DAILY_QUOTA_EXCEEDED	429	Cota diária da API excedida
INTERNAL_ERROR	500	Erro interno do servidor

Exemplo de resposta de erro:

json

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

more.md

Voltar para a documentação