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
    Top-Ups
    • Overview
    • Study Building
    • Subject Recruitment
    • Dedicated Support
    Checkout
  • Contact
    • FR
      • 中國人
      • Deutsch
      • Français
      • Español
      • English
      • 日本語
    • Appgo to app icon
    • 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 top-up packages →
    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
    • 日本語
    • Commencer
    • Guide
      • COMMENCER

        • Éditeur de Tâches
        • Cadres
          • Cadre Canvas
          • Cadre de Page
          • Cadre de site Web
        • Chronologie de l'Essai
        • Présentation des Stimuli
        • Exactitude de la Réponse
        • Objets
        • Événements
        • Variables
        • Assistant de Tâches
        • Système d'Essai
        • Conception d'Expériences
          • Création d'une étude
          • Importer des modèles dans Labvanced
          • Modèles de Cadre de Données
          • Conception d'expérience multi-utilisateur
          • Conception d'Expérience Longitudinale
      • SUJETS EN VEDETTE

        • Randomisation & Équilibre
        • Suivi des Yeux
          • Présentation des Stimuli dans une Tâche de Suivi oculaire
          • Comment Choisir les Paramètres de Calibration du Suivi Oculaire
          • Configuration du suivi oculaire dans une tâche
          • Enregistrement et Exportation des Données de Regard
          • Utilisation des formes comme zones d'intérêt (AOI) pour le suivi oculaire
          • L'expérience de calibration des participants
        • Pont Web
          • Sélectionner les AOI de site Web | Ancrer, ajuster et vérifier le suivi des AOI
          • Suivi du comportement de la souris sur une AOI de site Web | Guide Web Bridge
        • Questionnaires
        • Application de Bureau
        • Études Échantillons
        • Recrutement de Participants
        • Accès API
          • API REST
          • API Webhook
          • API WebSocket
        • Autres Sujets

          • Horaires des Stimuli Précis
          • Études Multi-Utilisateurs
          • Suivi de la tête dans Labvanced | Guide
      • ONGLETS PRINCIPAUX DE L'APPLICATION

        • Aperçu : Onglets Principaux
        • Tableau de Bord
        • Mes Études
        • Études Partagées
        • Mes Fichiers
        • Bibliothèque d'Expériences
        • Mon Compte
        • Licence & Services
      • ONGLETS D'ÉTUDE

        • Aperçu : Onglets Spécifiques à l'Étude
        • Conception de l'Étude
          • Tâches
          • Blocs
          • Sessions
          • Groupes
        • Éditeur de Tâches
          • Contrôles de tâche
          • Le Système des Essais
          • Types de cadres
          • Objets
          • Tables de Propriétés des Objets
          • Variables
          • Tableau des Variables Système
          • Le Système d'Événements
          • Fonctions de l'Éditeur de Texte
          • Options de suivi oculaire dans l'éditeur de tâches
          • Suivi de tête dans une tâche
          • Études multi-utilisateurs
        • Paramètres
        • Variables
        • Médias
        • Texte & Traduire
        • Lancer & Participer
        • Gestion des Sujets
        • Dataview et Exporter
    • Tutoriels vidéo
      • Aperçu vidéo
      • Initiation à Labvanced
      • Création de tâches
      • Vidéos sur les éléments
      • Événements et variables
      • Sujets avancés
    • Guides
      • Introduction
      • Tâche de Stroop
      • Tâche de décision lexicale
      • Tâche de cueing oculaire de Posner
      • Paradigme de clignotement de cécité au changement
      • Étude d'exemple de suivi oculaire
      • Étude de suivi oculaire des nourrissons
      • Étude de capture attentionnelle avec suivi de souris
      • Présentation visuelle sérielle rapide
      • Étude ChatGPT
      • Démo de suivi oculaire : SVGs comme AOIs
      • Démo multi-utilisateur : Afficher les curseurs des sujets
      • Configuration de base du contrôleur Gamepad / Joystick
      • Étude sur application de bureau avec intégration EEG
      • Équilibrage de groupe et configuration des variables entre sujets
      • Construction d'une étude multi-utilisateur
      • Guide de suivi oculaire de cadre de site web
      • Suivi oculaire conditionnel par webcam
      • Construction d'une étude de segmentation de texte
      • Construction d'une étude avec IA
    • FAQ
      • Fonctionnalités
      • Politique de support et directives
      • Sécurité et confidentialité des données
      • Licences
      • Précision de Labvanced
      • Utilisation programmatique et API
      • Utilisation de Labvanced hors ligne
      • Dépannage
      • Questions sur la création d'études

    API REST

    Labvanced propose une API REST permettant aux utilisateurs de récupérer des données depuis le serveur Labvanced, après que le(s) participant(s) ait (aient) terminé l'étude.

    L'API REST est authentifiée par un jeton, qui vous permet de télécharger toutes vos données de manière programmatique. L'API REST est idéale pour les organisations et les institutions de recherche académique qui souhaitent centraliser leur récupération de données et stocker leurs données dans des endroits dédiés selon leur protocole de pipeline. Au lieu de sélectionner et de télécharger des données manuellement et de les enregistrer localement, cela permet aux organisations d'accéder aux données sur leurs serveurs, ce qui est également important pour le protocole GDPR.

    La documentation (Swagger UI) des points de terminaison REST peut être trouvée ici : https://www.labvanced.com/openapi.html

    Nous fournissons également une spécification openapi qui peut être utilisée pour générer automatiquement du code client pour différents langages de programmation (c'est-à-dire dans des outils comme Postman) : https://www.labvanced.com/labvanced-openapi.json

    Création du jeton API

    C'est une API sécurisée, ce qui signifie que vous devez valider l'accès à l'aide d'un jeton généré dans Labvanced afin d'accéder aux données.

    Pour créer le jeton, connectez-vous à l'application Labvanced et allez dans l'onglet « Mon compte » situé sur le côté gauche du menu.

    Il y a une section appelée « Identifiants API » et pour créer le jeton, il suffit de cliquer sur « Générer ».

    indiquant le bouton qui génère l'API REST

    Lorsque le jeton apparaît, double-cliquez sur la clé du jeton afin de tout sélectionner puis Ctrl+C pour le copier.

    Avec ce jeton, vous pourrez accéder aux données de vos études et des sessions pertinentes.

    Remarque : le jeton ne peut être généré que pour donner accès aux données de session par le propriétaire de l'étude.

    Essayez-le en utilisant notre documentation API (Swagger UI)

    Le moyen le plus simple d'essayer notre API est d'utiliser la fonctionnalité « Essayer » dans notre documentation API (Swagger UI) : https://www.labvanced.com/openapi.html

    Dans le coin supérieur droit, cliquez sur « Autoriser ».

    indiquant le bouton 'Autoriser' pour saisir l'API REST

    Cela ouvrira une boîte de dialogue vous invitant à entrer / coller le jeton dans le champ « Valeur ».

    Boîte de dialogue pour saisir les identifiants de l'API REST

    Une fois que vous avez collé le jeton, cliquez sur « Autoriser », puis « Fermer » pour fermer la boîte de dialogue.

    Remarque : Lorsque vous avez terminé de consulter les données, vous pouvez vous déconnecter de cette session en cliquant sur « Autoriser » situé dans le coin supérieur droit du site Web, puis, dans la boîte de dialogue qui apparaît, en cliquant sur le bouton « Déconnexion » qui apparaît dans le coin inférieur gauche.

    Essayez d'accéder aux données via notre documentation API

    Une fois connecté, vous pouvez utiliser ces deux zones pour accéder à vos données expérimentales :

    Options de données de l'API REST pour accéder aux sessions et aux données des participants

    • /api/{expId}/download/{recSessionId} : cette section vous permet d'accéder et de télécharger les données d'un participant unique. Lorsque les données sont téléchargées, elles seront au format de fichier .csv selon la configuration que vous avez spécifiée dans les exportSettings trouvés sur la page « Vue des données et exportation » dans l'application Labvanced.
    • /api/{expId}/sessions : permet de récupérer toutes les sessions pour une expérience spécifique en entrant l'« id de l'expérience ».

    Données de ‘/api/{expId}/sessions’

    Il est préférable de commencer par le deuxième point de terminaison pour d'abord savoir quelles sessions d'enregistrement (et leurs rec_session_id correspondants) existent dans une expérience donnée. Cliquez sur le deuxième champ bleu étiqueté /api/{expId}/sessions et il s'ouvrira dans une vue plus grande, puis cliquez sur le bouton « Essayer » sur le côté droit :

    Boîte de dialogue pour récupérer les données de l'expérience avec l'API REST basée sur l'id de session

    En cliquant sur « Essayer », vous pourrez saisir des numéros dans le champ « expid » pour indiquer l'id de l'expérience pour laquelle vous souhaitez accéder aux données de session. Vous pouvez le trouver dans labvanced dans la page "Mes études" dans la colonne "ID". Une fois que vous avez rempli ce champ, cliquez sur « Exécuter ».

    Une fois cela fait, vous pouvez faire défiler la page et voir les informations pour toutes les sessions dans cette expérience spécifique :

    Exemple de données de session générées à l'aide de l'API REST

    Veuillez noter l'un des rec_session_id dans le payload de réponse pour l'utiliser dans la section suivante afin de télécharger toutes les données enregistrées de cette session d'enregistrement.

    Remarque : Pour saisir un « id d'expérience » différent, cliquez simplement sur le bouton rouge « Annuler » sur le côté droit, afin de pouvoir entrer un nouvel « id d'expérience ».

    Données de ‘recSessionId’

    Pour accéder et télécharger les données d'un participant, cliquez sur le premier champ bleu étiqueté /api/{expId}/download/{recSessionId} et il s'ouvrira dans une vue plus grande, puis cliquez sur le bouton « Essayer » sur le côté droit :

    Dialogue pour spécifier l'id d'expérience et les numéros de session pour récupérer des données via l'API REST

    En cliquant sur « Essayer », vous pourrez entrer des numéros dans les deux champs qui apparaissent en indiquant l'« id d'expérience » et le « rec_session_id » que vous souhaitez télécharger (voir la section précédente).

    Une fois que vous avez saisi ces valeurs, il suffit de cliquer sur « Exécuter » et l'API sera exécutée. Ensuite, faites défiler la page, et vous verrez une option pour « Télécharger le fichier ».

    Télécharger des fichiers générés par l'API REST

    En cliquant sur « Télécharger le fichier », un .zip sera téléchargé contenant deux fichiers .csv, à savoir :

    • sessions.csv
    • trials.csv

    Ces fichiers contiendront toutes les données pertinentes pour la session spécifique et les données d'essai associées.

    Remarque : Pour récupérer une session différente, cliquez simplement sur le bouton rouge « Annuler » sur le côté droit, afin de pouvoir entrer un nouvel « id d'expérience » et un nouveau « rec_session_id » à télécharger.

    En conclusion, ces étapes vous permettent d'accéder aux données à l'aide du jeton API que vous avez généré avec un jeton unique et sécurisé dans Labvanced afin de consulter les données expérimentales et de session.

    Essayez-le avec Postman

    C'est une deuxième option pour essayer l'API pour ceux qui utilisent déjà Postman (une plateforme API) dans leurs activités quotidiennes. Le jeton API Labvanced fonctionne également à partir de là.

    Vous entrez l'URL dans le champ supérieur, basée sur le site Web de l'API Labvanced.

    Ensuite, sélectionnez la clé et collez le jeton sous la colonne « valeur », comme montré ci-dessous :

    Démonstration de l'utilisation de POSTMAN avec l'API REST générée par Labvanced

    De cette façon, les données de session pour une expérience seront accessibles via Postman.

    De même, vous pouvez suivre le même processus pour télécharger des fichiers pour un participant spécifique.

    En procédant ainsi, l'aperçu affichera des caractères étranges, mais cela est normal car cette commande sert à récupérer des fichiers. Lorsque vous cliquez sur « Enregistrer les réponses » et « Enregistrer dans un fichier », les données pour le participant particulier apparaîtront normalement.

    Démonstration de l'apparence des données basées sur des fichiers dans POSTMAN avec l'API REST de Labvanced

    Next
    API Webhook