AI APIs para Construtores ATS
Nesta página
Esta página é para equipes de produto e engenharia que desenvolvem software de recrutamento. O Curriculo transforma currículos, requisitos de emprego e entrevistas em dados estruturados e prontos para decisão. Você envia um documento ou uma gravação; você recebe de volta campos limpos, uma pontuação de ajuste, uma tradução, uma transcrição ou um resumo de contratação.
O API não é mais um painel que os usuários devem acessar. Seu produto mantém os registros de candidatos, o fluxo de trabalho de emprego e o console do recrutador UI. O Curriculo faz o trabalho de processamento de linguagem e mídia por trás, por meio de uma chave da Console de Desenvolvedor .
O que o API faz
| Capacidade | O que você envia | O que você recebe de volta |
|---|---|---|
| Analise CV | Um ou mais currículos (PDF ou DOCX) em uma solicitação única. | O currículo completo como dados limpos e estruturados: nome, detalhes de contato, histórico de trabalho, educação, habilidades. Os valores permanecem no idioma e script próprios do CV. |
| Avalie o candidato | Um ou mais currículos (PDF ou DOCX) e o emprego, como texto, documento ou registrado job_id. | Uma pontuação de adequação com justificativa escrita, habilidades correspondentes, lacunas e pontos resumidos, para cada CV. |
| Traduzir | Até 200 strings, ou PDF e DOCX documentos. | Traduções na ordem em que foram enviadas, para qualquer um dos 85 idiomas. Um item com falha nunca colapsa o lote. |
| Detectar idioma | Um texto, ou até 200. | O idioma de cada um, para que você possa rotear uma CV ou mensagem antes de agir sobre ela. |
| Resumo de entrevista | Uma transcrição, um documento de transcrição (PDF ou DOCX), ou uma gravação (vídeo ou áudio). | Destaque, bandeiras vermelhas, habilidades mencionadas e uma recomendação com justificativa. Gravações vêm com sua transcrição. |
| Transcrever | Uma gravação. | Apenas a transcrição. |
| Assistente de currículo | Um CV uma vez, então instruções em linguagem simples. | Um currículo funcional que você pode questionar, editar ou renderizar em outro idioma sem precisar reenviar. |
| Entrevista de triagem | E-mails dos candidatos, perguntas e seu retorno de chamada URL. | Curriculo envia e-mails para cada candidato, hospeda a entrevista gravada, transcreve cada resposta e envia, assinada, para o seu servidor. |
Grandes filas e gravações longas são executadas como tarefas em segundo plano : envie links ou faça uploads, obtenha um task_id de uma vez, e colete o resultado por meio de polling ou callback assinada.
O API não é um segundo ATS.
POST /jobs/armazena um emprego apenas como uma descrição para avaliar currículos.
Exemplo de integração ATS
| Etapa | Seu sistema | Curriculo |
|---|---|---|
| 1. Contexto do trabalho | Armazena o trabalho e o registra uma vez com POST /jobs/ (gratuito) ou envia job_details em linha. | Usa-o para avaliar candidatos. |
| 2. Ingresso | Envia currículos para /parse/ e /evaluate/, ou links para /parse/async e /evaluate/async para um backlog. | Retorna currículos estruturados e avaliações, em ordem. |
| 3. Seleção | Chama POST /screening-interview com e-mails de candidatos, perguntas e um callback_url. | Envia convites, hospeda a gravação, transcreve respostas. |
| 4. Resultados | Verifica X-Curriculo-Signature, então armazena transcrições, avaliações e links de gravação. | Envia resultados assinados como candidatos concluem. |
| 5. Entrevistas | Envia gravações ou transcrições para /summary/. | Retorna destaques, bandeiras vermelhas e uma recomendação. |
Multilíngue por padrão
- Envie currículos em qualquer idioma. Análise e avaliação leem o documento como escrito, sem pré-processamento do seu lado.
- Nada é reescrito silenciosamente. Valores analisados retornam no idioma e script próprios do CV.
- Escolha o idioma de saída. Avaliação, resumos de entrevistas e o assistente de currículo aceitam uma configuração de
language. - Detecte antes de encaminhar. Ramifique um fluxo de trabalho antes que qualquer humano leia o documento.
Veja Idiomas.
Começando
- Crie sua conta no console .curriculo.me. O cadastro é autoatendido, e um crédito gratuito de $5.00 cobre suas primeiras chamadas.
- Gere um API chave na página de chaves API . Ela funciona imediatamente para todas as operações. A chave é exibida apenas uma vez, então armazene-a em um local seguro.
- Tente cada capacidade a partir da documentação interativa com um CV real ou transcrição.
- Entregue a chave à sua equipe de engenharia. Cada capacidade é uma solicitação única, então a integração é pequena e autônoma.
O walkthrough completo está no Início Rápido.
Volume, velocidade e limites
Veja Limites de taxa e Loteamento.
O que esperar operacionalmente
- Cada solicitação está isolada. Um documento com falha nunca afeta outro, e reenviar um documento com falha é sempre seguro.
- Erros são explícitos. Uma solicitação rejeitada informa o motivo. Veja Erros.
- Solicitações com falha não são cobradas. Nem tarefas de segundo plano com falha ou convites de triagem com falha.
- Uso é visível por chave. Emita chaves separadas para ambientes ou equipes separados.
- Saiba o que é armazenado. Chamadas síncronas de parse, avaliação, tradução, detecção de idioma, resumo e transcrição não mantêm nada. Trabalhos registrados, o assistente de currículo, tarefas de segundo plano e entrevistas de triagem mantêm dados. Veja Manipulação de dados.
Faturamento
Pré-pago e por solicitação, sem assinatura: $0.01 para a maioria das operações, $0.001 para detecção de idioma, $0.002 por minuto de áudio para gravações, e $0.02 por convite de triagem enviado. Uma lista de currículos em uma solicitação é cobrada como uma unidade. Tabela completa em Preços e faturamento.
Curriculo dentro do seu AI assistente
Separadamente do API, equipes no Curriculo ATS podem trabalhar seu pipeline de contratação a partir do Claude, ChatGPT, Cursor e outros clientes. É um produto diferente com seu próprio login, e uma chave API não alcança suas ferramentas. Veja a documentação MCP.
Atualizado em