ATS 빌더를 위한 Curriculo APIs

개요 #

API가 무엇인지, 무엇이 아닌지.

Curriculo API는 Curriculo ATS 제품이 이미 실행 중인 동일한 채용 인텔리전스 엔진을 노출합니다. 개발자 콘솔의 Bearer 키로 직접 호출합니다. ATS 로그인, 세션 쿠키 및 조직 헤더가 포함되지 않습니다.

자신의 ATS, 구인 게시판 또는 모집 워크플로를 위한 AI 및 미디어 레이어로 사용하세요. 귀하의 제품은 후보자, 일자리, 상태 및 채용 UI를 소유하고, Curriculo는 무대 뒤에서 중대한 작업을 제공합니다.

모든 기능은 통합하기 전에 대화형 문서에서 실행할 수 있습니다: 작업을 선택하고, 키를 붙여넣고, 실제 CV를 첨부하고, 응답을 읽습니다. 통합 작업 없이도 자신의 데이터에서 출력 품질을 스스로 판단할 수 있습니다.

API는 두 번째 ATS가 아닙니다

POST /jobs/를 이 API에서 호출하면 요구 사항의 문자열로만 작업이 저장되므로 이를 기준으로 CV 목록을 평가할 수 있습니다. 이는 Curriculo ATS Jobs API가 아닙니다: 보드가 없고, 페이지가 없으며, 조직 작업 목록이 없습니다. 콘솔 ATS API는 자체 페이지 네이션을 유지하며, 공개 API는 단일 요청에서 목록을 받습니다.

빠른 시작 #

가입부터 작업 호출까지, 판매 대화 없이.

Authorization: Bearer key_...

인증 #

하나의 키, 전체 스위트.

모든 요청은 Bearer 토큰으로 개발자 콘솔 키를 포함합니다. 콘솔 키는 공용 API 스위트를 즉시 활성화합니다. 온보딩 호출이 없으며 기능별 요청이 없습니다. 프롬프트, 파싱, 평가, 번역, 언어 감지, 전사, 인터뷰 요약 및 스크리닝 인터뷰가 모두 같은 계정과 같은 잔액에서 진행됩니다.

기능 #

당신이 보내는 것, Curriculo가 처리하는 것, 그리고 돌아오는 것.

참조 요청 #

모든 기능은 짧고 고정된 입력 세트로 하나의 요청입니다.

필수 입력은 유효한 요청을 위한 최소값입니다; 선택적 입력은 결과를 정제합니다. CV 작업의 경우, 요구 사항, 언어 및 설정과 함께 작업을 한 번 등록합니다. 그런 다음 모든 CV로 요구 사항을 반복하는 대신 해당 작업 참조에 대한 문서 목록을 전송합니다.

CV 구문 분석

동기 호출은 files 필드에 CV를 첨부합니다(PDF 또는 DOCX, 각 최대 10 MB). 비동기 호출은 동일한 파일, HTTPS file_urls (한 줄당 하나 또는 JSON 목록) 또는 둘 다 최대 25개의 CV를 수용합니다. 선택적 callback_url을 추가하면 결과가 준비되었을 때 POST합니다. 이를 생략하면 작업을 폴링합니다.

후보자 평가

동기 호출은 resume_pdf 또는 resume_pdfs에 PDF를 첨부합니다. 비동기 호출은 동일한 파일, HTTPS resume_urls (한 줄당 하나 또는 JSON 목록) 또는 둘 다 최대 25개의 CV를 수용합니다. POST /jobs/ 또는 인라인 job_details에서 job_id를 전송합니다. 선택적 callback_url을 추가하면 결과가 준비되었을 때 POST합니다. 이를 생략하면 작업을 폴링합니다.

번역

번역은 요청된 언어 쌍에 대해 가능한 최상의 경로를 사용합니다. 직접 응답에 recommended_async: true가 포함된 경우 해당 쌍에 대해 생산 트래픽에 POST /translate/async를 사용합니다.

언어 감지

인터뷰 요약

프롬프트 / 이력서 보조 도구

인터랙티브 문서에는 특정 기능에 대한 정확한 입력이 나열되어 있어, 코드 작성을 하기 전에 필수 세트를 확인하고 테스트할 수 있습니다.

선별 면접

POST https://api.curriculo.me/public/screening-interview를 호출하십시오. 후보자의 이메일 주소, 질문, 직무 메타데이터 및 콜백 URL을 전송합니다. Curriculo는 각 후보자에게 인터뷰 링크를 이메일로 보냅니다. 각 답변이 들어오면 이를 귀하의 callback_url에 POST합니다. 실패한 주소는 다른 주소를 취소하지 않습니다.

이것은 간단한 이메일 래퍼가 아니라 구성된 채용 워크플로입니다. Curriculo는 초대 전송, 브라우저 녹화, 개인 미디어 저장, 필기록, 번역 준비된 답변 텍스트, 평가 메타데이터 및 서명된 콜백을 처리하므로 귀하의 ATS는 채용 담당자에게 직접 보여줄 수 있는 후보자 증거를 수신합니다.

호출은 202를 응답하며, screening_id, 한번만 표시되는 callback_secret, sent_count, 그리고 invites 목록을 포함합니다. 각 초대는 sent 또는 failed입니다. 선별 면접은 발송된 후보자 초대당 $0.02입니다; 실패한 초대는 청구되지 않습니다.

{
  "candidate_emails": ["[email protected]"],
  "questions": ["시스템을 출시한 경험에 대해 이야기해 주세요."],
  "callback_url": "https://example.com/screening",
  "job_title": "백엔드 엔지니어"
}

각 답변은 귀하의 서버에 대한 하나의 서명된 POST입니다. X-Curriculo-Signature는 sha256= plus raw body의 HMAC-SHA256입니다. completed는 그 후보자가 모든 질문에 대한 최종 답변을 가질 때까지 false로 유지됩니다. question_index는 0에서 시작합니다.

{
  "screening_id": "...",
  "email": "[email protected]",
  "question": "시스템을 출시한 경험에 대해 이야기해 주세요.",
  "question_index": 0,
  "transcript": "청구 서비스가 출시되었습니다.",
  "recording_url": "https://api.curriculo.me/public/screening-interview/.../recording",
  "media_kind": "비디오",
  "duration_seconds": 142,
  "completed": false
}

이 recording_url는 비공식 Curriculo 미디어 링크로, 원시 S3 URL이 아닙니다. 이는 후보자가 답변을 전사문 및 평가 맥락과 함께 시청할 수 있는 ATS 결과 페이지를 위한 것입니다. 오래된 링크가 만료되면, 다시 선별 결과를 요청하여 새로운 미디어 URL을 받으십시오.

언어 #

채용은 거의 단일 언어가 아니므로, 언어 처리는 추가 기능으로 판매되는 것이 아니라 모든 기능에 내장되어 있습니다.

• 모든 언어로 이력서를 전송합니다. 파싱 및 평가는 문서에 작성된 대로 아랍어, 한국어, 일본어, 힌디어, 프랑스어, 포르투갈어 또는 러시아어를 읽습니다. 귀하 측에서전처리를 하지 않습니다.
• 아무것도 조용히 수정되지 않습니다. 파싱된 값은 이력서의 자체 언어 및 스크립트로 반환되므로, 이름이나 고용주가 후보자가 인식하지 못할 어떤 것으로 음역되거나 변환되지 않습니다.
• 번역은 유럽어, 중동, 남아시아, 동아시아 및 동남아시아, 아프리카 및 지역 언어를 포함하여 200개 이상의 언어를 지원합니다. API는 요청된 원본 및 대상 언어 쌍에 대해 가장 적절한 경로를 선택합니다.
• 출력 언어를 선택합니다. 평가, 면접 요약 및 이력서 보조 도구는 각각 언어 설정을 수락하므로 아랍어 이력서를 영어로 평가하거나 영어 이력서를 한국어로 렌더링할 수 있습니다.
• 언어 탐지는 인간이 문서를 읽기 전에 워크플로를 가지쳐 나갈 수 있도록 하여, 적합한 채용 담당자를 지정하거나 올바른 템플릿을 먼저 선택할 수 있게 해줍니다.

제한 사항 및 성능 #

전망이 아닌 생산에서 측정됩니다. 이 사항을 기반으로 계획을 세우면 출시 시 놀라움이 없습니다.

오류 & 신뢰성 #

운영적으로 기대할 수 있는 것.

• 각 요청은 독립적입니다. 하나의 문서가 실패해도 다른 문서에 영향을 주지 않으며, 실패한 문서를 다시 보내는 것은 항상 안전합니다. 이는 중복 또는 반 finished 기록을 생성할 수 없기 때문입니다.
• 거부된 요청은 이유를 알려줍니다: 파일 크기가 너무 크거나, 형식이 잘못되었거나, 키가 누락되었거나, 처리가 너무 오래 걸렸습니다. 조용히 실패하는 것은 없습니다.
• 배치는 우아하게 저하됩니다. 어떤 목록 요청에서든 단일 항목이 실패하면 그 항목의 오류가 반환되고 나머지 결과는 정상적으로, 보낸 순서대로 돌아옵니다.
• 속도 제한도 동일하게 작동합니다. 키당 600 요청을 초과하면 서비스 저하 대신 속도 제한 응답을 반환합니다.

API 가격 #

게시된 셀프 서비스 가격. 인프라 공식, 배수기 또는 숨겨진 설정 비용 없음.

셀프 서비스: 무료 크레딧, 그 후 사용한 만큼 지불

단일 키와 단일 잔액이 모든 호출을 커버합니다. 구문 분석 및 평가에는 파일을 첨부하거나 HTTPS 이력서 링크를 붙여넣거나 둘 다 보낼 수 있습니다. 비동기 호출에는 콜백 URL을 포함할 수 있습니다; 결과가 준비되면 POST하고, 콜백을 생략하면 폴링이 여전히 작동합니다.

사용 가시성

콘솔은 호출, 청구 가능한 사용량, 오류 및 해당 기간에 대한 예상 요금을 보여주므로 어떤 비용이 청구되기 전에 조정할 수 있습니다. 환경이나 팀별로 개별 키를 발급하여 사용량을 추적하고 키를 독립적으로 무효화할 수 있습니다.

파트너 및 리셀러 가격

재판매 또는 고정된 볼륨에 대해 계약하에 호출당 가격을 책정합니다. 파트너 요율은 계약에 따라 제공되며, 각 engagements마다 확인됩니다. 예상하는 월별 호출량을 알려주시면 요율 및 그에 따른 조건을 확인하겠습니다.

• 이력서 도우미는 호출당 $0.01입니다, PDF를 첨부한 호출을 포함합니다.
• 모든 금액은 USD이며, 현지 세금은 제외됩니다. 현지 통화 청구는 engagement당 가격이 책정됩니다.

데이터 처리 #

우리가 보존하는 것, 보존하지 않는 것, 그리고 키가 도달할 수 있는 것.

• 귀하의 데이터는 귀하의 것입니다. 프롬프트 세션 외부와 선별 인터뷰 결과를 제외하고, 원샷 API 호출은 귀하가 보낸 문서를 보유하지 않습니다.
• 키는 귀하의 조직에 묶여 있으며 다른 것은 볼 수 없습니다.
• 구문 분석된 출력은 CV의 고유 언어와 스크립트를 보존하므로 귀하가 요청하지 않는 한 이름이나 고용주는 음역되지 않습니다.
• 취소는 즉시 가능하며 셀프 서비스입니다. 콘솔에서 손상된 키를 취소하고 교체 키를 발급하세요. 다른 키는 영향을 받지 않습니다.

사용 약관 #

모든 API 키에 적용되는 운영 조건.

• 액세스. 개발자 콘솔 키는 하나의 계정과 하나의 잔고에서 공개 API 스위트를 활성화합니다. 키는 셀프 서비스 방식으로 발급되며 언제든지 귀하가 취소할 수 있습니다.
• 요금 부과. 각 호출은 해당 작업에 대한 게시된 가격으로 청구됩니다. $5.00 가입 크레딧이 먼저 차감됩니다. 이를 초과하면 귀하의 저장된 카드가 선택한 잔고 기준을 유지하기 위해 청구됩니다. 구독이 없고 최소 약정이 없습니다.
• 공정 사용. 게시된 처리량은 공유 서비스 용량으로, 예약된 용량이 아닙니다. 키당 분당 600요청 제한이 적용되며, 이를 초과하면 속도 제한 응답이 반환됩니다.
• 청구 단위. 하나의 요청은 하나의 요금입니다. 한 번의 호출로 10개의 CV 목록도 여전히 $0.01입니다.
• 세금. 모든 금액은 USD이며 지역 세금은 제외됩니다.
• 파트너 약관. 재판매 및 약속된 볼륨 가격은 참여별로 계약되며 셀프 서비스 요금이 아닙니다.

Claude 및 ChatGPT에서의 Curriculo ATS (MCP) #

공식 API와는 별개의 제품입니다.

Curriculo ATS에 이미 있는 팀의 경우, 도우미가 평범한 언어로 채용 파이프라인을 작업할 수 있습니다. 커넥터를 추가하는 데 약 1분이 소요됩니다: 주소를 붙여넣고 로그인한 후 승인합니다. 이는 두 도우미가 지원하는 개방형 표준인 모델 컨텍스트 프로토콜을 사용하므로 귀하의 팀이 유지해야 할 별도의 것이 없습니다.

귀하는 Curriculo ATS 계정으로 로그인하고 접근을 승인하며, 모든 작업은 귀하의 조직에 한정됩니다.

MCP 도구 카탈로그 #

스무다섯 개 도구. 접근 유형이 위험을 알려줍니다.

읽기만 찾아봅니다. 쓰기는 ATS 데이터를 변경합니다. 쓰기+는 데이터를 변경하고 외부로 접근하므로 이메일이 발송되거나 초대가 전송되거나 AI 작업이 시작됩니다. 스무다섯 개 중 열일곱 개는 읽기 전용이며, 여섯 개의 쓰기+ 도구는 사용 전에 귀하의 확인을 받습니다.

메일 도구는 연결된 사서함이 필요합니다. 인터뷰 일정 예약은 필요하지 않습니다. 연결된 캘린더가 없으면 인터뷰가 저장되며 초대장이 발송되지 않았다고 보고됩니다.

자주 묻는 질문 #

지원 #

다음 단계.

• api.curriculo.me/public/docs의 인터랙티브 API 참조는 모든 작업을 나열하고 브라우저에서 테스트할 수 있습니다. Postman 컬렉션이 콘솔 문서 페이지에 있습니다.
• console.curriculo.me의 개발자 콘솔은 키, 사용량, 잔액 및 요청 템플릿을 보유합니다.
• MCP 설정, 인증 및 전체 도구 참조는 curriculo.me/docs/mcp/에 있습니다.
• 대량 작업량, 파트너 약관 또는 법적 문서에 대해서는 [email protected]로 작성하세요. 작업량의 형태를 알려주시면 빌드 전에 계획을 확인하겠습니다.