APIs do AI para construtores do ATS
Nesta página
Esta página é para equipes de produto e engenharia que desenvolvem software de recrutamento. O Curriculo API transforma currículos, requisitos de vagas e entrevistas em dados estruturados, prontos para a tomada de decisão. Você envia um documento ou uma gravação; recebe de volta campos limpos, uma pontuação de adequação, uma tradução, uma transcrição ou um resumo de contratação.
O API não é outro painel de controle para o qual seus usuários precisam fazer login. Seu produto mantém registros de candidatos, o fluxo de trabalho e o recrutador UI. O Curriculo API faz o AI, trabalho de linguagem e mídia por trás, através de uma chave do Console de Desenvolvedor .
Qual Curriculo e API deve usar o meu ATS?
Use para analisar , convertendo currículos recebidos em registros estruturados de candidatos, avaliá-los com pontuação conforme uma vaga, traduzir e detectar idiomas para pipelines multilíngues, além de resumir ou transcrever gravações de entrevistas. Seu ATS mantém as telas de candidatos, vagas e recrutadores; o Curriculo e o API realizam a gestão de documentos, idiomas e mídia por trás deles, com uma única chave.
O que o API faz
| Capacidade | O que você envia | O que você recebe de volta |
|---|---|---|
| Análise de CV | Um ou mais currículos (PDF ou DOCX) em uma única solicitação. | O currículo completo em dados estruturados e limpos: nome, dados de contato, experiência profissional, formação académica, competências. Os valores permanecem no próprio idioma e na escrita do CV. |
| Avaliar candidato | Um ou mais currículos (PDF ou DOCX) e a vaga, como texto, um documento ou registrado job_id. | Uma pontuação de adequação com raciocínio escrito, habilidades correspondentes, lacunas e pontos resumidos, para cada CV. |
| Traduzir | Até 200 strings, ou documentos PDF e DOCX. | Traduções na ordem em que foram enviadas, para qualquer um dos 202 idiomas. Um item defeituoso nunca derruba o lote. |
| Detectar idioma | Um texto, ou até 200. | O idioma de cada um, para que você possa rotear um CV ou mensagem antes de agir sobre ele. |
| Resumo da entrevista | Uma transcrição, um documento de transcrição (PDF ou DOCX) ou uma gravação (vídeo ou áudio). | Destaques, sinais de alerta, habilidades mencionadas e uma recomendação com justificativa. As gravações retornam com suas transcrições. |
| Transcrever | Uma gravação. | Apenas a transcrição. |
| Assistente de resumo | Um CV uma vez, depois instruções em linguagem simples. | Um currículo funcional que você pode questionar, editar ou traduzir para outro idioma sem precisar fazer upload novamente. |
| Entrevista de triagem | E-mails de candidatos, perguntas e sua chamada de retorno URL. | O Curriculo envia um e-mail para cada candidato, hospeda a entrevista gravada, transcreve cada resposta e a POSTa, assinada, ao seu servidor. |
Grandes atrasos e gravações longas são executados como tarefas em segundo plano : enviar links ou uploads, receber um task_id de uma só vez e coletar o resultado por meio de polling ou callback assinado.
O API não é um segundo ATS. O
POST /jobs/armazena um trabalho apenas como uma descrição para avaliar currículos. Não há listagem, paginação, organização nem pipeline.
Integração do exemplo ATS
| Passo | Seu sistema | Curriculo |
|---|---|---|
| 1. Contexto de trabalho | Armazena o trabalho e registra-o uma vez com POST /jobs/ (gratuito) ou envia job_details inline. | Usa-o para pontuar candidatos. |
| 2. Entrada | Envia currículos para /parse/ e /evaluate/, ou links para /parse/async e /evaluate/async para um backlog. | Retorna currículos e avaliações estruturados, em ordem. |
| 3. Roteirização | Chama POST /screening-interview com e-mails de candidatos, perguntas e um callback_url. | Envia convites, hospeda a gravação e transcreve as respostas. |
| 4. Resultados | Verifica X-Curriculo-Signature, depois armazena transcrições, avaliações e links de gravação. | Os resultados assinados são publicados em POSTs à medida que os candidatos terminam. |
| 5. Entrevistas | Envia gravações ou transcrições para /summary/. | Retorna destaques, pontos de atenção e uma recomendação. |
Multilíngue por padrão
- Enviar currículos em qualquer idioma. Análise e avaliação leem o documento conforme escrito, sem pré-processamento do seu lado.
- Nada é reescrito silenciosamente. Os valores analisados do retornam no próprio idioma e script do CV.
- Escolha o idioma de saída. Avaliação, resumos de entrevistas e o assistente de currículos aceitam cada um
languageconfiguração. - Detecte antes de rotear. Ramifique um fluxo de trabalho antes de qualquer pessoa ler o documento.
Começando
- Crie sua conta na console.curriculo.me. O cadastro é autosserviço, e um crédito gratuito de $5.00 cobre suas primeiras chamadas.
- Gere uma chave API na página de chaves API . Ela funciona imediatamente para todas as operações. A chave é exibida apenas uma vez, portanto, guarde-a em local seguro.
- Teste cada capacidade a API referência com uma chamada real ou transcrição.
- Entregue a chave à sua equipe de engenharia. Cada capacidade é uma solicitação única, portanto a integração é pequena e autossuficiente.
O guia completo está no Quickstart.
Volume, velocidade e limites
Veja Limites de taxa e Agrupamento , .
O que esperar operacionalmente
- Cada solicitação é independente. Um documento que falha nunca afeta outro, e reenviar um documento com falha é sempre seguro.
- Os erros são explícitos. Uma solicitação rejeitada informa o motivo. Ver Erros .
- As solicitações com falha não são cobradas. Nem as tarefas em segundo plano com falha nem os convites de triagem com falha.
- O uso é visível por chave. Emita chaves separadas para ambientes ou equipes diferentes.
- Sabe o que é armazenado. A análise, avaliação, tradução, detecção de idioma, resumo e transcrição síncronos de chamadas não retêm nada além de trechos curtos registrados quando uma chamada AI falha. Trabalhos registrados, o assistente de currículos, tarefas em segundo plano e entrevistas de triagem mantêm dados. Consulte Manipulação de dados.
Faturamento
Pré-pago e sob demanda, sem assinatura: $0.01 para a maioria das operações (por CV ou documento para listas), $0.001 para detecção de idioma, cerca de $0.002 por minuto de áudio para gravações e $0.02 por convite de triagem enviado. Tabela completa em Precificação e faturamento.
Curriculo dentro do seu assistente AI
Separadamente do API, as 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 do e MCP.
FAQ
Meu usuário ATS precisa de um login Curriculo?
Não. Seu produto chama o Curriculo API com uma chave do Console de Desenvolvedor. Seus usuários nunca fazem login no Curriculo.
Os dados dos candidatos são armazenados?
Não pelas operações síncronas, exceto por breves trechos registrados quando uma chamada AI falha. As tarefas em segundo plano, os trabalhos registrados, os currículos salvos e as entrevistas de triagem mantêm dados; consulte Manipulação de dados.
Posso enviar currículos em qualquer idioma?
Sim. Os valores analisados permanecem no próprio idioma e sistema de escrita do CV, e o tradutor abrange 202 idiomas.
Atualizado em