DGT Exams Extractor

Extrae preguntas y respuestas de los tests teóricos de conducir de la DGT de España con este Actor de Apify. Ideal para crear aplicaciones educativas, plataformas de autoescuela y sistemas de práctica de exámenes con datos estructurados y listos para usar.

¿Qué hace este Actor?

DGT Exams Extractor automatiza la obtención de preguntas de examen teórico de conducir desde la plataforma oficial de la DGT, proporcionándote:

• 📝 Preguntas completas: enunciado, imagen asociada y opciones de respuesta
• ✅ Respuestas correctas marcadas: cada opción indica si es la correcta
• 🎯 Cobertura total del 100%: soporta los 33 tipos de permisos y certificaciones disponibles en la DGT
• 🌐 8 idiomas oficiales: acceso a las versiones multiidioma de la DGT (sujeto a disponibilidad)
• 📊 Datos estructurados: formato JSON estandarizado y documentado

Características principales

• Cobertura completa del 100%: soporta todos los 33 tipos de permisos y certificaciones disponibles en la DGT
• Extracción automatizada de preguntas oficiales de exámenes teóricos
• 8 idiomas oficiales: castellano, catalán, valenciano, gallego, euskera, alemán, inglés y francés
• Datos estructurados siguiendo un schema JSON validado
• Imágenes incluidas con URLs directas a recursos oficiales
• Identificación de respuestas correctas para sistemas de evaluación automática
• Modelo de pago transparente basado en eventos de uso

Configuración de entrada

El Actor acepta los siguientes parámetros de entrada:

Campo	Tipo	Por defecto	Descripción
idPermiso	string (enum)	"1" (Permiso B)	Tipo de permiso de conducir para el test
idIdioma	string (enum)	"1" (Castellano)	Idioma en el que se mostrarán las preguntas

Tipos de permiso disponibles

El Actor soporta todos los 33 tipos de permisos y certificaciones disponibles en la DGT (cobertura del 100%):

Permisos de conducir básicos:

• "1" - Permiso B (turismos) - Sin coste adicional
• "4" - AM (ciclomotores)
• "5" - A1 y A2 (motocicletas)
• "6" - BE (turismos con remolque)
• "7" - C (camiones)
• "8" - D (autobuses)
• "9" - CE y DE (camiones/autobuses con remolque)

Permisos especiales:

• "2" - Vehículos personas movilidad reducida
• "3" - Vehículos agrícolas
• "10" - C1 97
• "11" - C1E 97

Certificados profesionales (CAP) - 14 perfiles completos:

• "12" a "17" - Perfiles 1-6
• "18" a "25" - Perfiles A-H

Certificados ADR (mercancías peligrosas) - 8 certificaciones:

• "26" - Prueba básica
• "27" - Radiactivas
• "28" - Cisternas
• "29" - Explosivos
• "30" a "33" - Renovaciones (básica, radiactivas, cisternas, explosivos)

Nota: Seleccionar cualquier permiso diferente al B ("1") incluye un coste adicional de $0.06 por ejecución.

Idiomas disponibles

El Actor extrae preguntas en las versiones oficiales multiidioma de la DGT (sujeto a disponibilidad según tipo de permiso):

Código	Idioma	Coste adicional
"1"	Castellano	Sin coste
"2"	Catalán	+$0.02
"3"	Valenciano	+$0.02
"4"	Gallego	+$0.02
"5"	Euskera	+$0.02
"6"	Alemán	+$0.02
"7"	Inglés	+$0.02
"8"	Francés	+$0.02

Importante: La disponibilidad de idiomas depende del tipo de permiso seleccionado. No todos los permisos tienen versiones disponibles en todos los idiomas. Si un idioma no está disponible para el permiso seleccionado, el Actor devolverá el contenido en castellano.

Nota: Seleccionar cualquier idioma diferente al Castellano ("1") incluye un coste adicional de $0.02 por ejecución.

Ejemplo de configuración

Test básico en castellano (coste mínimo):

{
  "idPermiso": "1",
  "idIdioma": "1"
}

Test de motocicletas en inglés:

{
  "idPermiso": "5",
  "idIdioma": "7"
}

Test de mercancías peligrosas en euskera:

{
  "idPermiso": "27",
  "idIdioma": "5"
}

Formato de salida

Los datos se devuelven como un array de objetos JSON siguiendo este schema:

Objeto Principal: PreguntaExamen

Campo	Tipo	Descripción
id	integer	Identificador único de la pregunta dentro del test extraído
idPreguntaCuest	integer	Identificador de la pregunta en el cuestionario DGT (único dentro del test)
enunciado	string	Texto completo de la pregunta del examen
urlImagen	string (URI)	URL de la imagen asociada (formato HTTPS, extensión .jpg)
respuestas	array	Array de objetos Respuesta con las opciones disponibles

Objeto Anidado: Respuesta

Campo	Tipo	Descripción
id	integer	Identificador único de la opción de respuesta
idPregunta	integer	Referencia al id de la pregunta padre
contenido	string	Texto de la opción de respuesta
correcta	boolean	Indica si esta opción es la respuesta correcta

Ejemplo de salida

[
  {
    "id": 1,
    "idPreguntaCuest": 1,
    "enunciado": "Los turismos, ¿están obligados a llevar espejo retrovisor izquierdo?",
    "urlImagen": "https://sedeclave.dgt.gob.es/EXAM/WEB_AUTO6/IMAGENES/20_VEHICULOS_PARTES/ESPEJOS/MT45390.jpg",
    "respuestas": [
      {
        "id": 1,
        "idPregunta": 1,
        "contenido": "No, es opcional.",
        "correcta": false
      },
      {
        "id": 2,
        "idPregunta": 1,
        "contenido": "Sí, es obligatorio.",
        "correcta": true
      },
      {
        "id": 3,
        "idPregunta": 1,
        "contenido": "Solo si el retrovisor interior no permite una visión completa de la vía.",
        "correcta": false
      }
    ]
  }
]

Nota importante sobre identificadores

Los identificadores (id e idPreguntaCuest) son únicos dentro del test extraído, pero no son IDs globales persistentes entre ejecuciones.

Para seguimiento a largo plazo o deduplicación entre múltiples extracciones, se recomienda usar:

• Combinación única: datasetId (de Apify) + enunciado (texto de la pregunta)
• Hash del enunciado: generar un hash SHA-256 del texto de la pregunta

Modelo de precios (Pay Per Event)

Este Actor utiliza un modelo de pago por evento:

Evento	Coste	Descripción
actor_start	$0.15	Inicio del Actor (cargo base por ejecución)
specific_permit	$0.06	Adicional por extraer un permiso diferente al B (códigos 2-33)
translation	$0.02	Adicional por idioma diferente al castellano (códigos 2-8)

Ejemplos de coste total

Configuración	Permiso	Idioma	Coste
Básica	B	Castellano	$0.15
Motocicletas	A1/A2	Castellano	$0.21 ($0.15 + $0.06)
Turismos	B	Inglés	$0.17 ($0.15 + $0.02)
Camiones	C	Gallego	$0.23 ($0.15 + $0.06 + $0.02)
ADR Explosivos	Explosivos	Francés	$0.23 ($0.15 + $0.06 + $0.02)

Cálculo rápido:

• Solo permiso B en castellano: $0.15
• Otro permiso en castellano: $0.21
• Permiso B en otro idioma: $0.17
• Otro permiso en otro idioma: $0.23

Casos de uso

• Apps de autoescuela: crea aplicaciones móviles o web para preparar el examen teórico
• Plataformas educativas: integra tests interactivos en sistemas de e-learning
• Simuladores de examen: genera exámenes de práctica con preguntas oficiales
• Análisis estadístico: estudia la distribución de temas y dificultad de preguntas
• Bases de datos de preguntas: alimenta sistemas de gestión de contenido educativo
• Chatbots educativos: integra preguntas en asistentes virtuales para preparación de exámenes

Integración

Con Apify Client

Puedes integrar este Actor en tu aplicación usando el Apify Client para JavaScript/Node.js, Python u otros lenguajes soportados. Consulta la documentación oficial de Apify para más detalles sobre cómo ejecutar Actors y obtener sus resultados.

El flujo básico consiste en:

1. Ejecutar el Actor con los parámetros deseados
2. Obtener el ID del Dataset generado
3. Descargar los items del Dataset con las preguntas

Formatos de exportación

Los datos extraídos están disponibles en múltiples formatos desde el Dataset:

• JSON - formato estructurado ideal para APIs y procesamiento
• CSV - compatible con Excel y herramientas de análisis
• HTML - para visualización rápida
• RSS - para suscripciones y actualizaciones

Buenas prácticas

Caché de resultados

Para optimizar costes y rendimiento, se recomienda implementar un sistema de caché que almacene los resultados durante un período de tiempo razonable (por ejemplo, 24 horas), evitando ejecuciones innecesarias del Actor para los mismos tests.

Deduplicación de preguntas

Si ejecutas el Actor múltiples veces y combinas resultados, puedes encontrar preguntas duplicadas. Para identificarlas de forma única entre ejecuciones, genera un hash del campo enunciado de cada pregunta y úsalo como identificador único en tu base de datos.

Validación de datos

Antes de usar las preguntas en tu aplicación, verifica que cada pregunta tenga exactamente una respuesta marcada como correcta. Esto asegura la integridad de tus tests y evita errores en la evaluación.

Limitaciones y consideraciones legales

⚠️ Aviso importante:

• Este Actor es no oficial y no está afiliado, avalado ni respaldado por la Dirección General de Tráfico (DGT)
• La información extraída está destinada únicamente a fines educativos y de práctica para la preparación del examen teórico
• El uso de los datos obtenidos es responsabilidad exclusiva del usuario
• Debes cumplir con los términos de servicio de la DGT y la normativa vigente sobre propiedad intelectual
• No utilices este servicio para fines comerciales sin consultar la legalidad correspondiente
• El autor no se hace responsable del uso indebido de los datos extraídos

Recomendaciones de uso ético

• Usa los datos exclusivamente para preparación educativa de exámenes
• No redistribuyas masivamente las preguntas sin autorización
• Respeta los derechos de autor del contenido oficial
• Atribuye la fuente original (DGT) en tus aplicaciones
• No modifiques las preguntas de forma que distorsionen su contenido educativo

Preguntas frecuentes

¿Con qué frecuencia se actualizan las preguntas? Las preguntas se extraen en tiempo real de la plataforma DGT. Si la DGT actualiza su banco de preguntas, este Actor reflejará esos cambios en la próxima ejecución.

¿Puedo obtener tests para todos los tipos de permiso? Sí, el Actor tiene cobertura del 100% de los permisos disponibles en la DGT: 33 tipos diferentes incluyendo permisos de conducir básicos, especiales, certificados CAP (14 perfiles) y certificados ADR de mercancías peligrosas (8 certificaciones).

¿Todos los permisos están disponibles en todos los idiomas? No, la disponibilidad de idiomas varía según el tipo de permiso. La DGT proporciona versiones multiidioma solo para ciertos permisos. Si un idioma no está disponible para el permiso seleccionado, el Actor devolverá el contenido en castellano.

¿Los idiomas son traducciones automáticas? No, los idiomas disponibles son las versiones oficiales proporcionadas por la DGT cuando están disponibles. No se aplican traducciones automáticas.

¿Los IDs son estables entre ejecuciones? No, los IDs internos pueden variar. Usa el hash del enunciado o la combinación dataset+enunciado para seguimiento persistente.

¿Cuántas preguntas tiene cada test? Los tests oficiales de la DGT suelen tener 30 preguntas. El número exacto puede variar según el tipo de permiso o certificación.

Soporte

Para reportar problemas, sugerencias o consultas sobre este Actor, contacta con el desarrollador a través de Apify Console o los canales especificados en el perfil del Actor.

Reporte de bugs

Si encuentras algún problema:

1. Verifica que tu configuración de entrada sea correcta
2. Revisa los logs de ejecución en Apify Console
3. Incluye el runId al reportar el problema
4. Describe el comportamiento esperado vs el comportamiento actual

---

Versión de la documentación: 1.0
Última actualización: Enero 2026