Pular para o conteúdo

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

CapacidadeO que você enviaO que você recebe de volta
Análise de CVUm 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 candidatoUm 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.
TraduzirAté 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 idiomaUm 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 entrevistaUma 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.
TranscreverUma gravação.Apenas a transcrição.
Assistente de resumoUm 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 triagemE-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

PassoSeu sistemaCurriculo
1. Contexto de trabalhoArmazena o trabalho e registra-o uma vez com POST /jobs/ (gratuito) ou envia job_details inline.Usa-o para pontuar candidatos.
2. EntradaEnvia 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çãoChama POST /screening-interview com e-mails de candidatos, perguntas e um callback_url.Envia convites, hospeda a gravação e transcreve as respostas.
4. ResultadosVerifica 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. EntrevistasEnvia 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 language configuração.
  • Detecte antes de rotear. Ramifique um fluxo de trabalho antes de qualquer pessoa ler o documento.

Ver Idiomas .

Começando

  1. Crie sua conta na console.curriculo.me. O cadastro é autosserviço, e um crédito gratuito de $5.00 cobre suas primeiras chamadas.
  2. 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.
  3. Teste cada capacidade a API referência com uma chamada real ou transcrição.
  4. 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

O queValorPor que importa
Tamanho do documentoAté 10 MBCobre essencialmente todo o CV real, incluindo os digitalizados e com design pesado.
Tempo de processamento do CVCerca de 10 a 90 segundosAnálise real de AI, não correspondência de palavras-chave. Trate-o como uma tarefa em segundo plano, não como uma carga de página.
Capacidade de processamentoAproximadamente 2 a 4 currículos por minutoUma estimativa. O trabalho pesado executa três operações ao mesmo tempo, com a capacidade compartilhada entre os serviços, de modo que o rendimento varia conforme a carga.
Tradução em uma única chamada200 strings, 50.000 caracteresUma página de carreiras completa ou CV em uma única solicitação.
Transcrições de entrevistas200.000 caracteresConfortavelmente se encaixa em uma entrevista com painel, palavra por palavra.
GravaçõesAté 100 MB em um upload síncrono de /summary/ ; até 1 GB ou 2 horas por linkAs longas entrevistas passam pela via assíncrona .
Taxa de solicitação600 solicitações por minuto, por chaveExcedê-lo retorna 429.

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.

Esta página foi útil?

Atualizado em