Referencia de Endpoint

Lote JSON

Name: EvalCV API
Rating: 4.9 (120 reviews)

Envíe hasta 500 currículums pre-analizados como objetos JSON en una sola solicitud. Cada entrada puede incluir un external_candidate_id opcional — su propia referencia opaca (ID ATS, user_id, etc.) que almacenamos y devolvemos en todos los resultados.

POST/v1/batch-json

Parámetros de Solicitud

Nombre	Tipo	Descripción
job_idRequerido	string	Un job_id válido obtenido mediante POST /v1/create-job o POST /v1/parse-job.
language	string	Código de idioma para el análisis IA (ej: 'en', 'fr', 'es'). Por defecto: 'en'.
candidatesRequerido	array	Matriz de objetos de candidatos (1–500). Cada elemento contiene un 'resume' (JSON ParsedResume) y un 'external_candidate_id' opcional (cadena, máx 255 caracteres).

Consejo Pro

Maneje siempre los encabezados de límite de velocidad en su lógica. Para un mejor rendimiento, utilice el procesamiento asíncrono para archivos grandes.

curl -X POST https://api.evalcv.com/v1/batch-json \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "YOUR_JOB_ID",
    "language": "en",
    "candidates": [
      {
        "external_candidate_id": "ATS-EMP-0042",
        "resume": {
          "name": "Jane Doe",
          "email": "jane@example.com",
          "skills": ["Python", "FastAPI"],
          "experience": [],
          "education": []
        }
      }
    ]
  }'