Curriculo ATS REST API

Integração

Acesso programático completo aos seus dados de contratação. Crie vagas, obtenha pontuações de candidatos, sincronize pipelines e construa fluxos de trabalho personalizados. Disponível no plano Pro ($50/mês).

O Curriculo ATS REST API fornece acesso programático completo aos seus dados de contratação, permitindo que as equipes criem vagas, obtenham pontuações de candidatos, gerenciem estágios de pipeline e construam integrações personalizadas com HRIS, folha de pagamento e ferramentas de relatórios. O API utiliza convenções padrão REST com respostas JSON, autenticação de chave API e eventos de webhook para atualizações em tempo real. Disponível no plano Pro por $50 por mês, sem taxas por solicitação dentro dos limites de taxa.

API Capacidades

CRUD para Vagas e Candidatos

Crie, leia, atualize e exclua vagas e candidatos de forma programática. Publique novas listagens de vagas a partir de ferramentas internas, atualize estágios de candidatos em massa e sincronize perfis de candidatos com sistemas externos. Operações CRUD completas em todos os recursos principais.

Pontuações e Dados de Pipeline

Obtenha Pontuações de Impacto (0–100) e quebras de dimensão para cada candidato. Consulte estágios de pipeline, acompanhe a progressão do candidato e obtenha métricas de contratação agregadas para painéis e relatórios personalizados.

Eventos de Webhook

Assine eventos de webhook em tempo real: nova candidatura recebida, candidato pontuado, alteração de estágio, oferta enviada, candidato contratado. Cada webhook entrega uma carga de payload JSON com contexto de evento completo para o seu endpoint.

Exportação em Massa

Exporte dados de candidatos, resultados de pontuação e instantâneos de pipeline em massa. Extraia todos os candidatos para uma função, todas as pontuações em diferentes funções ou o histórico completo da pipeline para cumprir requisitos de conformidade e relatórios.

Utilizar Casos

Sincronizar com HRIS e Folha de Pagamento

Quando um candidato é marcado como contratado em Curriculo ATS, envie automaticamente seu perfil para o seu HRIS (BambooHR, Rippling, etc.) ou sistema de folha de pagamento (Gusto, ADP). Elimine a entrada manual de dados entre a contratação e o processo de integração.

Painéis de Análise Personalizados

Extraia métricas de contratação via o API e crie painéis personalizados na ferramenta de sua escolha, Looker, Metabase ou Google Planilhas. Acompanhe o tempo de contratação, qualidade da fonte, distribuição de pontuações e taxas de conversão de funil.

Postagem de Vagas Automatizada

Crie listagens de vagas em Curriculo ATS de forma programática a partir de suas ferramentas internas ou site de carreiras CMS. Quando sua equipe abre uma nova vaga, o API cria a vaga, define os critérios de pontuação e ativa a pipeline automaticamente.

Enriquecimento de Dados de Candidatos

Utilize webhooks para disparar fluxos de trabalho de enriquecimento quando novos candidatos se aplicam. Extraia dados adicionais do Clearbit, LinkedIn ou seus próprios bancos de dados, então escreva perfis enriquecidos de volta para Curriculo ATS via o API.

Técnico

Autenticação & Limites de Taxa

Autenticação por Chave API

Gere uma chave API a partir do painel de controle Curriculo ATS em Configurações > API. Inclua a chave no cabeçalho de Autorização de cada solicitação. As chaves podem ser rotacionadas a qualquer momento sem interromper as integrações ativas.

Limites de Taxa

Os limites de taxa padrão são 100 solicitações por minuto por chave API. O API retorna códigos de status 429 quando os limites são excedidos, com um cabeçalho Retry-After indicando quando tentar novamente. Limites mais altos estão disponíveis no plano Enterprise.

Documentação

A documentação completa API está disponível no portal de desenvolvedores Curriculo ATS para assinantes do plano Pro. Inclui um explorador interativo API, exemplos de código em cURL, Python, Node.js e Ruby, além de ferramentas de teste de webhook.

Exemplo de Código

Crie um novo anúncio de emprego com uma única chamada API.

# Create a new job listing
curl -X POSThttps://api.curriculo.me/v1/jobs \
-H"Authorization: Bearer YOUR_API_KEY" \
-H"Content-Type: application/json" \
-d'{
"title": "Senior Backend Engineer",
"department": "Engineering",
"location": "Remote",
"employment_type": "full_time",
"description": "Build and scale our API infrastructure...",
"scoring_criteria": {
"role_fit_weight": 40,
"outcomes_weight": 35,
"context_weight": 25
}
}'