Identidad y contacto
Puesto, nombre, apellidos, dirección, ciudad, país, teléfono y correos disponibles.
API REST de parsing de CV · integración con ATS y RR. HH.
Integra el parsing de CV en tu ATS mediante una API REST
Envía un CV a la API REST de CVReaderPro, recibe una respuesta estructurada y usa los datos en tu ATS, software de RR. HH. o aplicación empresarial.
Prueba de 14 días · 200 créditos · sin tarjeta bancaria
Del documento a los datos
CV enviado → datos estructurados → uso en tu software
CVReaderPro extrae los datos del documento. Tu backend recibe la respuesta y decide cómo asignarla, guardarla y mostrarla en tu propio modelo de candidato.
- 01
1. Enviar el CV
Tu backend envía el archivo a un endpoint de parsing.
- 02
2. Elegir el parser
Selecciona el modo según el documento y el nivel de detalle necesario.
- 03
3. Recibir los datos
La API devuelve propiedades estructuradas en una respuesta JSON o XML.
- 04
4. Usar el resultado
Tu aplicación asigna los campos devueltos a su ATS, CRM o base de candidatos.
¿Qué datos puedes recuperar de un CV?
Las propiedades devueltas dependen del parser elegido y de la información detectada en el documento.
Experiencia profesional
Puestos, empresas, periodos, ubicaciones, descripciones e indicación de empleo actual.
Formación
Títulos, centros, fechas y descripciones disponibles.
Competencias e idiomas
Competencias estructuradas, idiomas detectados y niveles identificables.
Perfil y nivel de experiencia
Texto del perfil, nivel de experiencia y formación cuando el parser los devuelve.
Otras propiedades
Habilidades sociales, referencias, enlaces sociales, aficiones y texto extraído cuando el esquema lo contempla.
Los 56 o 96 campos son propiedades disponibles, no valores garantizados. Los datos ausentes o no utilizables en el CV pueden quedar vacíos.
Ver los esquemas completos en la documentaciónEjemplo de respuesta
Del CV al JSON estructurado
A la izquierda, un CV PDF sintético; a la derecha, su respuesta JSON correspondiente de IA 56 tomada de los ejemplos públicos. El bloque muestra datos que un ATS puede asociar a su propio modelo de candidato.
CV fuente sintético
Alex Sample — ingeniero Java sénior — París. Perfil ficticio para ilustrar el flujo.
Descargar el CV fuente (PDF)Los valores son ficticios. Los campos y contenidos completados varían según el CV y el parser elegido.
Descargar el archivo JSON completo{
"documentType": "CV",
"documentLanguage": "en",
"candidate": {
"jobTitle": "Senior Java Engineer",
"title": "Mr",
"firstName": "Alex",
"lastName": "Sample",
"dayOfBirth": "",
"monthOfBirth": "",
"yearOfBirth": "",
"address": "Paris, France",
"postalCode": "",
"city": "Paris",
"country": "FR",
"department": "",
"region": "",
"phone": "",
"mobilePhone": "",
"driverLicense": "",
"personalEmail": "alex.sample@example.invalid",
"professionalEmail": "",
"nationality": "",
"children": ""
},
"profile": "Synthetic senior Java engineer with 8 years of experience developing Java, Spring Boot and PostgreSQL services. Builds REST APIs and leads engineering teams.",
"experienceLevel": "96",
"experiences": [
{
"startMonth": "01",
"endMonth": "10",
"startYear": "2020",
"endYear": "2026",
"mission": "Senior Java Engineer",
"company": "Example Systems (synthetic)",
"location": null,
"description": "Built Spring Boot REST APIs and PostgreSQL services. Led a team of four engineers. Introduced CI pipelines and automated integration checks.",
"currentPosition": true
},
{
"startMonth": "09",
"endMonth": "12",
"startYear": "2018",
"endYear": "2019",
"mission": "Java Engineer",
"company": "Example Labs (synthetic)",
"location": null,
"description": "Developed Java backend services, SQL reports and REST integrations.",
"currentPosition": false
}
],
"educationLevel": "DESS, DEA, Grande Ecoles, Bac +5",
"educations": [
{
"dateReceived": "2018",
"title": "Master of Computer Science",
"school": "Example University (synthetic)",
"description": ""
}
],
"languages": [
{
"name": "English",
"level": "Fluent"
},
{
"name": "French",
"level": "Bilingual"
}
],
"skills": [
{
"name": "Spring Boot",
"level": "Confirmed"
},
{
"name": "Java",
"level": "Confirmed"
},
{
"name": "PostgreSQL",
"level": "Experienced"
}
],
"softSkills": [
"Leadership",
"problem solving",
"communication"
],
"references": [],
"socialLinks": null,
"hobbies": "",
"resumeId": "00000000-0000-0000-0000-000000000001"
}Inicio técnico
Realiza tu primera llamada a la API
Autentica la solicitud en el servidor, envía el CV como multipart/form-data y procesa la respuesta estructurada.
1. Crear una clave API
Genera una clave en tu cuenta y guárdala en el servidor.
2. Enviar un documento
Llama al endpoint estándar con el archivo CV en el campo file.
3. Elegir el modo
El parámetro parserType es opcional en el endpoint estándar.
4. Procesar la respuesta
Solicita application/json y asigna las propiedades a tu software.
Ejemplo cURL
curl --fail-with-body -X POST "https://cvreaderpro.com/api/v2/resumes/parser" \
-H "Authorization: ApiKey YOUR_API_KEY" \
-H "Accept: application/json" \
-F "file=@resume.pdf" \
-F "parserType=ADVANCED"Opciones del parser y endpoint ampliado
En POST /api/v2/resumes/parser, BASIC activa el parsing por reglas (56 campos) y ADVANCED activa IA 56 (56 campos). Para IA 96, utiliza POST /api/v2/resumes/extended-parser: es un endpoint independiente, no un valor de parserType del endpoint estándar.
POST /api/v2/resumes/extended-parserEl parser ampliado acepta un archivo o un campo text en una solicitud multipart. Envía exactamente una entrada y consulta la documentación para conocer los requisitos de acceso.
Documentación de la APINo expongas una clave API privada en JavaScript que se ejecute en el navegador. Consulta la documentación para ver parámetros, errores y límites de cada endpoint.
Elige el nivel de parsing para tu integración
Adapta el parser al contexto necesario y al coste de procesamiento por CV.
| Modo | Créditos / CV | Campos disponibles | Uso habitual |
|---|---|---|---|
| Parsing por reglas | 1 | 56 | Extracción estandarizada para procesar CV en volumen. |
| Parsing IA 56 | 3 | 56 | Interpretación con IA cuando el documento requiere más contexto. |
| Parsing IA 96 | 5 | 96 | Parser ampliado para una representación más detallada. |
IA 96 utiliza un endpoint específico: POST /api/v2/resumes/extended-parser. Acepta un archivo o texto, una única entrada por solicitud. El acceso puede depender de una prueba activa o del plan asociado a la clave API.
El número de campos disponibles no garantiza que se extraigan todos los valores del CV.
Descubrir el parsing de CV por reglasDiseñada para equipos técnicos
Integra el parsing en tu ATS o software de RR. HH.
CVReaderPro proporciona el parsing y la respuesta estructurada. Tu aplicación conserva el control del flujo y del modelo de datos.
Proveedores de ATS
Añade extracción de CV al flujo de candidaturas y asigna la respuesta a tu modelo de candidato.
Software de RR. HH.
Envía los datos útiles a las fichas de candidatos y flujos de RR. HH. existentes.
Empresas de servicios tecnológicos e integraciones internas
Conecta el parsing con herramientas empresariales, portales de candidatos o pipelines de procesamiento.
Equipos técnicos
Procesa la respuesta en el backend, gestiona errores y decide qué datos mostrar o guardar.
La API proporciona datos estructurados, no un conector nativo para cada ATS. El mapeo, la interfaz y las reglas de negocio se implementan o configuran en tu software.
Respuestas, errores y webhooks
Prepara tu integración para gestionar respuestas correctas, errores y eventos asíncronos.
Parsing estándar
POST /api/v2/resumes/parserPOST /api/v2/resumes/parser devuelve HTTP 200 en JSON o XML según el encabezado Accept.
400Archivo CV no válido.401Falta la clave API o no es válida.402Créditos insuficientes.403Esta clave o cuenta no tiene permiso para procesar archivos.
Parser ampliado
POST /api/v2/resumes/extended-parser403Se requiere acceso al parser o una prueba activa.422No se pudo analizar el documento.429Se alcanzó el límite de solicitudes del parser ampliado.
Formatos, límites técnicos y datos de candidatos
Los formatos que se indican actualmente para la API de parsing de CV son:
- DOCX
El endpoint estándar recibe un archivo como multipart/form-data y el ejemplo cURL usa un PDF. La página pública de la API menciona PDF y DOCX; DOC y los archivos .txt no están confirmados para este endpoint. El endpoint ampliado también acepta una cadena de texto en el campo text, lo que no confirma que admita archivos .txt.
Límites que debes revisar antes de integrar
- Los límites de tamaño de archivo y frecuencia de solicitudes dependen del endpoint.
- Prepara el tratamiento de errores HTTP y respuestas 429 cuando se alcance el límite de solicitudes.
- La documentación de la API es la referencia para los parámetros y el comportamiento de cada endpoint.
¿Cuánto cuesta el parsing de CV por API?
Los créditos se descuentan por CV según el modo de parsing elegido.
| Modo | Créditos / CV | Hasta este número de CV con 200 créditos |
|---|---|---|
| Parsing por reglas | 1 | 200 |
| Parsing IA 56 | 3 | 66 |
| Parsing IA 96 | 5 | 40 |
Estos volúmenes suponen que los 200 créditos se destinan a un único modo. No se cuentan fracciones de CV.
La prueba incluye 200 créditos durante 14 días, sin tarjeta bancaria. Prueba CV representativos antes de desarrollar toda la integración.
Ver precios y créditosPreguntas frecuentes sobre la API de parsing de CV
¿Cómo integro la API de parsing con mi ATS?
Tu backend envía el CV a la API, recibe la respuesta estructurada y asigna las propiedades a los campos del ATS. El mapeo y la interfaz se gestionan en tu software.
¿Cómo obtengo una clave API?
Crea una cuenta y genera una clave en tu espacio. Usa el encabezado Authorization: ApiKey y conserva la clave privada en el servidor.
¿Qué formatos de CV puedo enviar?
La página pública de la API menciona PDF y DOCX. La referencia de POST /api/v2/resumes/parser usa un campo file multipart/form-data y un ejemplo PDF; no confirma DOC ni archivos .txt. El endpoint ampliado acepta una cadena de texto en el campo text, no necesariamente un archivo TXT.
¿Qué datos devuelve la API?
Según el parser, la respuesta puede incluir datos del candidato, experiencia, formación, idiomas, competencias, habilidades sociales, referencias, enlaces sociales y otras propiedades del esquema.
¿Cómo elijo entre reglas, IA 56 e IA 96?
El modo por reglas ofrece 56 campos por 1 crédito por CV. IA 56 usa 56 campos por 3 créditos. IA 96 ofrece 96 campos por 5 créditos cuando la integración necesita más detalle.
¿Se completan siempre todos los campos disponibles?
No. Una propiedad solo se completa si la información está presente y se puede utilizar en el CV. El resultado depende del documento y del parser.
¿Cómo recibo el resultado del parsing?
El endpoint estándar devuelve la respuesta a la solicitud. Solicita JSON con el encabezado Accept: application/json; algunos flujos asíncronos utilizan los webhooks documentados.
¿Cuántos CV puedo probar con 200 créditos?
Hasta 200 CV con parsing por reglas, 66 con IA 56 o 40 con IA 96 si todos los créditos se destinan a un modo.
¿Están disponibles todos los endpoints durante la prueba?
El acceso depende del endpoint, la clave API y el plan o prueba activa. Consulta la documentación para conocer los requisitos del parser ampliado.
Recursos para la integración
Explorar un ejemplo sintético
Descarga los CV de entrada y las salidas API capturadas. Todas las personas, empresas y ofertas son ficticias. Los documentos de ejemplo están en inglés; los resultados dependen del documento y del parser y requieren revisión humana.
Prueba la respuesta de parsing con tus CV
Comprueba los datos devueltos con documentos representativos y asigna después las propiedades a tu ATS o software de RR. HH.
Prueba de 14 días · 200 créditos · sin tarjeta bancaria