labvanced logoLabVanced
Contact
    • Remote Physiological Measurements
    • Eye Tracking
    • Head & Face-Tracking
    • Emotion Detection
    • Heart Rate Detection (rPPG)
    • Generative AI
    • Audio Transcription
    • EEG & Hardware Integrations
    • Decision Making
    • Reaction Times
    • Keyboard Inputs
    • Mouse Tracking
    • Mobile / Touch
    • Questionnaires
    • Gamepad / Joystick Integration
    • Audio Recordings
    • Audio Transcription
    • Video Recordings
    • Screen Recordings
    • Photos / Snapshots
    • Video Conferencing
    • Canvas Drawings
    • Build with AI
    • Build with Spreadsheets
    • Using the Experiment Editor
    • Coding
    • Creating Questionnaires
    • Balancing & Randomization
    • UX & Website Testing
    • Single Session Studies
    • Factorial Designs
    • Longitudinal & Multi-session Studies
    • Individual & Case Studies
    • Real-time Multi-user Studies
    • Interviews & Video Calls
    • Surveys & Questionnaires
    • Experience Sampling & Diaries
    • Classroom & Group Testing
    • Interventions & Clinical Trials
    • In the Browser
    • Mobile App
    • Desktop App
    • WebBridge Chrome Extension
    • Stroop Test
    • Flanker Task
    • N-back Task
    • Implicit Association Test
    • Trail Making Test
    • Digit Span
    • Corsi Block Tapping
    • Tower of London
    • Balloon Analog Risk Task
    • Preferential Looking
    • Browse more →
    • DASS-21
    • GAD-7
    • Rosenberg Self-Esteem Scale
    • PHQ-9
    • Ten-Item Personality Inventory
    • Big Five Personality Test
    • Adult ADHD Self-Report Scale
    • Browse more →
    • Building a Multi-user Study
    • Webcam Eye Tracking with AOIs
    • Website Frame Eye Tracking
    • Conditional Eye Tracking Opt-in
    • ChatGPT Study
    • Desktop App Study with EEG
    • Between-subjects Group Balancing
    • Building a Reading Study
    • Stroop Task
    • Lexical Decision Task
    • Browse more →
    Public Experiment Library
    • Arts Research
    • Clinical Psychology & Neuropsychology Medicine
    • Cognitive Psychology
    • Developmental Psychology
    • Behavioral Economics & Decision Science
    • Educational Research & Psychology
    • HCI & Human Factors
    • Linguistics & Language Sciences
    • Consumer & Marketing Research
    • Social & Personality Psychology
    • Sport & Movement Science
    • UX & Website Testing
    • Executive Functions
    • Language & Reading
    • Decision-Making & Reasoning
    • Attention
    • Overview
    • HCI & Human Factors
    • UX & Website Testing
    • Consumer & Marketing Research
    • White-Label App
    • PageGazer
    • Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela Markova
    • Eye Tracking for Influencer MarketingDr. Alexander Edeling
    • Eye Tracking Infant Word ComprehensionDr. Giulia Calignano
    • Sentence Reading and Grammar JudgmentsDr. Jonathan Mirault
    • Regulating Emotions with MusicDr. Katrin Starcke
    • Game-Based Grammar Learning in ChildrenDr. Mireia Marimon
    • Gaze Cueing and AutismMax Soares Miehstein
    • Personality and Hearing in NoiseDr. Malte Wöstmann
    • All interviews →
    • Lab Notes
    • How to Cite Labvanced
    • Labvanced Platform Paper (2017)
    • Webcam Eye Tracking Validation (2024)
    • Webcam Eye Tracking Studies
    • Cognitive Psychology Studies
    • Developmental Psychology Studies
    • Linguistics Studies
    • See all publications →
    • Getting Started
    • Guide
    • Video Tutorials
    • Walkthroughs
    • Live Chat
    • Webinars & Onboarding Calls
    • AI Assistant
    • FAQ
    • Importing Templates Guide
    • Test Templates
    • Live Eye Tracking Metrics
    • Mouse Tracking Demo
    • ChatGPT Demo
    • Audio Recording Object Demo
    • Adding Image Stimuli Demo
    • Score & Feedback Demo
    • Browse all technical demos →
    • Timing Precision
    • Stimuli Presentation
    • Headphone Checks
    • Bot Checks
    • Participant Management
    • Comparisons
    • Research Blog
    • Prolific Integration
    • CloudResearch Integration
    • Sona Systems Integration
    • BeSample Integration
    • Panelabs Integration
    • Clickworker Integration
    • Labvanced Webhook API
    • Labvanced REST API
    • About Us
    • Newsletter Archive
    • Terms & Conditions
    • Data Security & Data Privacy
    • Technical & Organisational Measures
    • Accessibility
    • W-8BEN-E Form
    • Data Processing Agreement Template
    LinkedInYouTubeDiscord
    • Individual
    • Lab
    • Department / Consortium
    • Teaching
    • Campus
    • Commercial
    • Browse recording top-ups →
    • Browse AI token top-ups →
    • Overview
    • Study Building
    • Subject Recruitment
    • Dedicated Support
    Checkout
  • Contact
    • ES
      • 中國人
      • Deutsch
      • Français
      • Español
      • English
      • 日本語
    • Logout
    • Loginlogin icon
    Platform
    Labvanced makes it easy to implement the most advanced study design and reliably collect your data.
    Biosignals & AI
    Remote Physiological MeasurementsEye TrackingHead & Face-TrackingEmotion DetectionHeart Rate Detection (rPPG)Generative AIAudio TranscriptionEEG & Hardware Integrations
    Behavioral Recordings
    Decision MakingReaction TimesKeyboard InputsMouse TrackingMobile / TouchQuestionnairesGamepad / Joystick Integration
    Media Recordings
    Audio RecordingsAudio TranscriptionVideo RecordingsScreen RecordingsPhotos / SnapshotsVideo ConferencingCanvas Drawings
    Implementation Techniques
    Build with AIBuild with SpreadsheetsUsing the Experiment EditorCodingCreating QuestionnairesBalancing & RandomizationUX & Website Testing
    Study Formats

    Your study can take whatever format your research needs. Here are a few popular examples.

    Single Session StudiesFactorial DesignsLongitudinal & Multi-session StudiesIndividual & Case StudiesReal-time Multi-user StudiesInterviews & Video CallsSurveys & QuestionnairesExperience Sampling & DiariesClassroom & Group TestingInterventions & Clinical Trials
    Where Studies Run

    Run your study online in the browser, on mobile or tablet with the mobile app, or in-lab with the desktop app.

    In the BrowserMobile AppDesktop AppWebBridge Chrome Extension
    Tests
    Explore cognitive tests, questionnaires, walkthroughs, and our public experiment library: a starting point for your next study.
    Popular Cognitive Tests
    Stroop TestFlanker TaskN-back TaskImplicit Association TestTrail Making TestDigit SpanCorsi Block TappingTower of LondonBalloon Analog Risk TaskPreferential Looking
    Browse more →
    Questionnaires & Scales
    DASS-21GAD-7Rosenberg Self-Esteem ScalePHQ-9Ten-Item Personality InventoryBig Five Personality TestAdult ADHD Self-Report Scale
    Browse more →
    Public Experiment Library

    Take a look at what other researchers in the community are doing through our extensive, open catalog of shared studies.

    Open the public library →
    Walkthroughs

    Step-by-step builds of complete studies, from a blank project to a running experiment, that you can follow along or adapt.

    Building a Multi-user StudyWebcam Eye Tracking with AOIsWebsite Frame Eye TrackingConditional Eye Tracking Opt-inChatGPT StudyDesktop App Study with EEGBetween-subjects Group BalancingBuilding a Reading StudyStroop TaskLexical Decision Task
    Browse more →
    Research
    One platform for students, academics, and industry researchers studying human behavior.
    Harvard UniversityStanford UniversityCambridge UniversityUCLNYUMax Planck InstituteUCLATU Munich

    Trusted by researchers at 1,500+ universities worldwide

    Academic Research
    Arts ResearchClinical Psychology & Neuropsychology MedicineCognitive PsychologyDevelopmental PsychologyBehavioral Economics & Decision ScienceEducational Research & PsychologyHCI & Human FactorsLinguistics & Language SciencesConsumer & Marketing ResearchSocial & Personality PsychologySport & Movement ScienceUX & Website Testing
    Research Areas
    Executive FunctionsLanguage & ReadingDecision-Making & ReasoningAttention
    Industry / Commercial
    OverviewHCI & Human FactorsUX & Website TestingConsumer & Marketing ResearchWhite-Label AppPageGazer
    Researcher Interviews

    Conversations with researchers about the studies they ran with Labvanced, what worked, and what they learned.

    Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela MarkovaEye Tracking for Influencer MarketingDr. Alexander EdelingEye Tracking Infant Word ComprehensionDr. Giulia CalignanoSentence Reading and Grammar JudgmentsDr. Jonathan MiraultRegulating Emotions with MusicDr. Katrin StarckeGame-Based Grammar Learning in ChildrenDr. Mireia MarimonGaze Cueing and AutismMax Soares MiehsteinPersonality and Hearing in NoiseDr. Malte Wöstmann
    All interviews →
    Our Research
    Lab NotesHow to Cite Labvanced
    Peer Reviewed Studies

    A selection of peer-reviewed work built on Labvanced: our own platform and validation papers, and studies by the research community grouped by area. Hundreds more are listed on the full publications page.

    Labvanced Platform Paper (2017)Webcam Eye Tracking Validation (2024)Webcam Eye Tracking StudiesCognitive Psychology StudiesDevelopmental Psychology StudiesLinguistics Studies
    See all publications →
    Resources
    Valuable resources to help you learn the platform, stay updated, and more.
    Documentation
    Getting StartedGuideVideo TutorialsWalkthroughs
    Support
    Live ChatWebinars & Onboarding CallsAI AssistantFAQ
    Templates & Demos

    These are a few popular examples. Browse our guide and a selection of technical demos to get started with implementation.

    Importing Templates GuideTest TemplatesLive Eye Tracking MetricsMouse Tracking DemoChatGPT DemoAudio Recording Object DemoAdding Image Stimuli DemoScore & Feedback Demo
    Browse all technical demos →
    Methodology
    Timing PrecisionStimuli PresentationHeadphone ChecksBot ChecksParticipant ManagementComparisonsResearch Blog
    Integrations & APIs
    Prolific IntegrationCloudResearch IntegrationSona Systems IntegrationBeSample IntegrationPanelabs IntegrationClickworker IntegrationLabvanced Webhook APILabvanced REST API
    Company & Legal
    About UsNewsletter ArchiveTerms & ConditionsData Security & Data PrivacyTechnical & Organisational MeasuresAccessibilityW-8BEN-E FormData Processing Agreement Template
    LinkedInYouTubeDiscord
    Pricing
    Our licenses and additional services at a glance.
    Licenses
    IndividualLabDepartment / ConsortiumTeachingCampusCommercial
    Top-Ups

    Need more recordings for your lab or your own research? Simply use one of these recording top-up packages.

    Browse recording top-ups →

    Need more AI tokens for the AI assistant and study translations? Simply use one of these AI token top-up packages.

    Browse AI token top-ups →
    Additional Services

    Hire Labvanced’s expert team to quickly bring your project to the level of rigor it needs.

    OverviewStudy BuildingSubject RecruitmentDedicated Support
    Checkout

    Ready to purchase a license or top-up? Head straight to checkout.

    Go to checkout →
    • 中國人
    • Deutsch
    • Français
    • Español
    • English
    • 日本語
    • Introducción
    • Guía
      • INTRODUCCIÓN

        • Editor de Tareas
        • Marcos
          • Marco de Canvas
          • Marco de Página
          • Marco de Sitio Web
          • Superposiciones y Diálogos | Labvanced
        • Cronograma de Pruebas
        • Presentación de Estímulos
        • Corrección de Respuestas
        • Objetos
        • Eventos
        • Variables
        • Asistente de Tareas
        • Asistente de IA
        • Sistema de Pruebas
        • Diseño de Experimentos
          • Crear un Estudio
          • Importando Plantillas en Labvanced
          • Patrones de Marco de Datos
          • Diseño de Experimentos Multiusuario
          • Diseño de Experimento Longitudinal
      • TEMAS DESTACADOS

        • Aleatorización y Equilibrio
        • Seguimiento Ocular
          • Presentación de Estímulos en una Tarea de Seguimiento Ocular
          • Cómo Elegir Configuraciones de Calibración para Seguimiento Ocular
          • Configuración del Seguimiento Ocular en una Tarea
          • Grabación y Exportación de Datos de Mirada
          • Usando Formas como Áreas de Interés (AOI) para Seguimiento Ocular
          • La Experiencia de Calibración del Participante
        • Puente Web
          • Selección de AOIs de Sitio Web | Anclar, Ajustar y Verificar el Seguimiento de AOI
          • Seguimiento del Comportamiento del Ratón en un AOI del Sitio Web | Guía del Puente Web
        • Cuestionarios
        • Aplicación de Escritorio
        • Estudios de Muestra
        • Reclutamiento de Participantes
        • Acceso a API
          • REST API
          • API de Webhook
          • WebSocket API
        • Otros Temas

          • Tempos de Estímulo Precisos
          • Estudios de Múltiples Usuarios
          • Seguimiento de Cabeza en Labvanced | Guía
      • TABS PRINCIPALES DE LA APLICACIÓN

        • Resumen: Pestañas Principales
        • Tablero
        • Mis Estudios
        • Estudios Compartidos
        • Mis Archivos
        • Biblioteca de Experimentos
        • Mi Cuenta
        • Licencia y Servicios
      • TABS DE ESTUDIO

        • Resumen: Pestañas Específicas del Estudio
        • Diseño del Estudio
          • Tareas
          • Bloques
          • Sesiones
          • Grupos
        • Editor de Tareas
          • Controles de Tarea
          • El Sistema de Pruebas
          • Tipos de Marcos
          • Objetos
          • Tablas de Propiedades de Objetos
          • Variables
          • Tabla de Variables del Sistema
          • El Sistema de Eventos
          • Funciones del Editor de Texto
          • Opciones de Seguimiento Ocular en el Editor de Tareas
          • Seguimiento de Cabeza en una Tarea
          • Estudios Multiusuario
        • Configuraciones
        • Variables
        • Medios
        • Textos y Traducción
        • Lanzar y Participar
        • Gestión de Sujetos
        • Vista de Datos y Exportación
    • Tutoriales en video
      • Descripción general del video
      • Introducción a Labvanced
      • Creando tareas
      • Videos de elementos
      • Eventos y variables
      • Temas avanzados
    • Guías
      • Introducción
      • Tarea de Stroop
      • Tarea de decisión léxica
      • Tarea de cuentagotas de Posner
      • Paradigma de parpadeo de ceguera al cambio
      • Estudio de seguimiento ocular
      • Estudio de seguimiento ocular en lactantes
      • Estudio de captura atencional con seguimiento de ratón
      • Presentación visual serial rápida
      • Estudio de ChatGPT
      • Demostración de seguimiento ocular: SVGs como AOIs
      • Demostración multiusuario: Mostrar los cursores de los sujetos
      • Gamepad / Controlador de joystick - Configuración básica
      • Estudio de aplicación de escritorio con integración de EEG
      • Balanceo de grupos entre sujetos y configuración de variables
      • Construyendo un estudio multiusuario
      • Guía de seguimiento ocular en marco de sitio web
      • Seguimiento ocular condicional con webcam
      • Construcción del estudio de segmentación de texto
      • Construyendo un estudio con IA
    • Preguntas frecuentes
      • Características
      • Política y directrices de soporte
      • Seguridad y privacidad de datos
      • Licencias
      • Precisión de Labvanced
      • Uso programático y API
      • Uso de Labvanced sin conexión
      • Solución de problemas
      • Preguntas sobre la creación de estudios

    API REST

    Labvanced ofrece una API REST para que los usuarios obtengan datos del servidor de Labvanced, después de que el/los participante(s) hayan completado el estudio.

    La API REST está autenticada con un token, que permite descargar todos tus datos de manera programática. La API REST es ideal para organizaciones e instituciones de investigación académica que desean centralizar la obtención de datos y almacenar sus datos en lugares dedicados según su protocolo de flujo de trabajo. En lugar de seleccionar y descargar datos manualmente y guardarlos localmente, esto permite que las organizaciones accedan a los datos en sus servidores, lo cual también es importante para el protocolo GDPR.

    La documentación (Swagger UI) de los endpoints REST se puede encontrar aquí: https://www.labvanced.com/openapi.html

    También proporcionamos una especificación openapi que se puede utilizar para autogenerar código cliente para diferentes lenguajes de programación (es decir, en herramientas como Postman): https://www.labvanced.com/labvanced-openapi.json

    Creando el Token de API

    Esta es una API segura, lo que significa que necesitas validar el acceso utilizando un token generado en Labvanced para poder acceder a los datos.

    Para crear el token, inicia sesión en la aplicación de Labvanced y ve a la pestaña ‘Mi Cuenta’ ubicada en el lado izquierdo del menú.

    Hay una sección llamada ‘Credenciales de API’ y para crear el token, simplemente haz clic en ‘Generar.’

    indicando el botón que genera la API REST

    Cuando aparezca el token, haz doble clic en la clave del token para resaltarla toda y luego Ctrl+C para copiarla.

    Con este token, podrás acceder a los datos de tus estudios y las sesiones relevantes.

    Nota: el token solo puede ser generado para dar acceso a los datos de la sesión por el propietario del estudio.

    Prueba con nuestra Documentación de API (Swagger UI)

    La forma más sencilla de probar nuestra API es utilizar la funcionalidad "Prueba" en nuestra documentación de API (Swagger UI): https://www.labvanced.com/openapi.html

    En la esquina superior derecha, haz clic en ‘Autorizar’.

    indicando el botón 'Autorizar' para introducir la API REST

    Esto abrirá un cuadro de diálogo que te pedirá que ingreses / pegues el token en el campo ‘Valor’.

    Cuadro de diálogo para introducir las credenciales de la API REST

    Una vez que pegues el token, haz clic en ‘Autorizar’ y luego en ‘Cerrar’ para cerrar el cuadro de diálogo.

    Nota: Cuando termines de ver los datos, puedes cerrar sesión en esta sesión haciendo clic en ‘Autorizar’ que se encuentra en la esquina superior derecha del sitio web y luego, en el cuadro de diálogo que aparece, haciendo clic en el botón ‘Cerrar sesión’ que aparece en la esquina inferior izquierda.

    Prueba Accediendo a los Datos a través de nuestra Documentación de API

    Una vez que hayas iniciado sesión, puedes utilizar estas dos áreas para acceder a tus datos experimentales:

    Opciones de datos de la API REST para acceder a sesiones y datos de participantes

    • /api/{expId}/download/{recSessionId}: esta sección te permite acceder y descargar los datos de un solo participante. Cuando se descarguen los datos, estarán en formato de archivo .csv según la configuración especificada en exportSettings que se encuentra en la página ‘Dataview & Export’ en la aplicación Labvanced.
    • /api/{expId}/sessions: te permite recuperar todas las sesiones para un experimento específico ingresando el ‘id del experimento.’

    Datos de ‘/api/{expId}/sessions’

    Es mejor comenzar con el segundo endpoint para primero averiguar qué sesiones de grabación (y sus correspondientes rec_session_id) existen en un experimento dado. Haz clic en el segundo campo azul etiquetado /api/{expId}/sessions y se abrirá en una vista más grande y haz clic en el botón ‘Probar’.

    Cuadro de diálogo para obtener datos del experimento con la API REST basado en el id de sesión

    Al hacer clic en ‘Probar’ podrás ingresar números en el campo ‘expid’ para indicar el id del experimento al que deseas acceder los datos de la sesión. Puedes encontrar esto en Labvanced en la página "Mis Estudios" en la columna "ID". Una vez que llenes este campo, haz clic en ‘Ejecutar.’

    Una vez que hagas esto, podrás desplazarte hacia abajo y ver la información de todas las sesiones en ese experimento específico:

    Ejemplo de datos de sesión generados usando la API REST

    Por favor, toma nota de uno de los rec_session_id del payload de respuesta para usarlo en la siguiente sección para descargar todos los datos grabados de esa sesión de grabación.

    Nota: Para ingresar un ‘id de experimento’ diferente, simplemente haz clic en el botón rojo ‘Cancelar’ en el lado derecho, para poder ingresar un nuevo ‘id de experimento.’

    Datos de ‘recSessionId’

    Para acceder y descargar los datos de un participante, haz clic en el primer campo azul etiquetado /api/{expId}/download/{recSessionId} y se abrirá en una vista más grande y haz clic en el botón ‘Probar’ en el lado derecho:

    Diálogo para especificar el id del experimento y los números de sesión para obtener datos a través de la API REST

    Al hacer clic en ‘Probar’, podrás ingresar números en los dos campos que aparecen indicando el ‘id del experimento’ y ‘rec_session_id’ que deseas descargar (ver sección anterior).

    Una vez que ingreses estos valores, simplemente haz clic en ‘Ejecutar’ y la API se ejecutará. Luego, desplázate hacia abajo, y verás una opción para ‘Descargar archivo.’

    Descargando archivos generados por la API REST

    Al hacer clic en ‘Descargar archivo’ se descargará un .zip que contiene dos archivos .csv, a saber:

    • sessions.csv
    • trials.csv

    Estos archivos contendrán todos los datos relevantes para la sesión específica y los datos de ensayo asociados.

    Nota: Para obtener una sesión diferente, simplemente haz clic en el botón rojo ‘Cancelar’ en el lado derecho, para poder ingresar un nuevo ‘id de experimento’ y un nuevo ‘rec_session_id’ para descargar.

    En conclusión, estos pasos te permiten acceder a datos utilizando el token de API que has generado usando un token único y seguro en Labvanced para visualizar datos experimentales y de sesión.

    Prueba usando Postman

    Esta es una segunda opción para probar la API para aquellos que ya están utilizando Postman (una plataforma de API) en sus actividades diarias. El token de API de Labvanced también funciona desde allí.

    Ingresa la URL en el campo superior, basándote en el sitio web de la API de Labvanced.

    Luego, selecciona la Clave y pega el token en la columna ‘valor’, como se muestra a continuación:

    Demostración de cómo usar POSTMAN con la API REST generada por Labvanced

    De esta manera, los datos de sesión para un experimento serán accesibles a través de Postman.

    De manera similar, puedes seguir el mismo proceso para descargar archivos para un participante específico.

    Al hacerlo, la vista previa mostrará caracteres extraños, pero esto es normal porque este comando es para obtener archivos. Cuando haces clic en ‘Guardar Respuestas’ y ‘Guardar en un archivo’, los datos del participante en particular aparecerán normalmente.

    Demostración de cómo aparecen los datos basados en archivos en POSTMAN con la API REST de Labvanced

    Next
    API de Webhook