Curriculo ATS REST API

Integração

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

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

Capacidades da API

CRUD para Empregos e Candidatos

Crie, leia, atualize e exclua empregos e candidatos programaticamente. Poste novas vagas de emprego 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 do Pipeline

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

Eventos de Webhook

Inscreva-se para eventos de webhook em tempo real: nova aplicação recebida, candidato pontuado, mudança de estágio, oferta enviada, candidato contratado. Cada webhook entrega uma carga útil JSON com todo o contexto do evento para seu endpoint.

Exportação em Massa

Exporte dados de candidatos, resultados de pontuação e instantâneas do pipeline em massa. Extraia todos os candidatos para um papel, todas as pontuações entre papéis ou todo o histórico do pipeline para requisitos de conformidade e relatórios.

Casos de Uso

Sincronização com HRIS e Folha de Pagamento

Quando um candidato é marcado como contratado no CurriculoATS, 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 contratação e integração.

Painéis de Análise Personalizados

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

Postagem Automatizada de Empregos

Crie anúncios de empregos no CurriculoATS programaticamente a partir de suas ferramentas internas ou CMS do site de carreiras. Quando sua equipe abre uma nova vaga, a API cria o emprego, define critérios de pontuação e ativa automaticamente o pipeline.

Enriquecimento de Dados de Candidatos

Use webhooks para acionar workflows de enriquecimento quando novos candidatos se inscrevem. Extraia dados adicionais do Clearbit, LinkedIn ou de seus próprios bancos de dados e escreva perfis enriquecidos de volta no Curriculo ATS via API.

Técnico

Autenticação e Limites de Taxa

Autenticação por Chave de API

Gere uma chave de API no seu painel CurriculoATS 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 integrações ativas.

Limites de Taxa

Os limites de taxa padrão são 100 solicitações por minuto por chave de API. A 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 da API está disponível no portal de desenvolvedores CurriculoATS para assinantes do plano Pro. Inclui explorador de API interativo, exemplos de código em cURL, Python, Node.js e Ruby, além de ferramentas de teste de webhook.

Exemplo de Código

Crie uma nova vaga de emprego com uma única chamada de API.

# Crie uma nova vaga de emprego
curl -X POST https://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": "Construa e escale nossa infraestrutura de API...",
"scoring_criteria": {
"role_fit_weight": 40,
"outcomes_weight": 35,
"context_weight": 25
}
}'