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
    • DE
      • 中國人
      • 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
    • 日本語
    • Erste Schritte
    • Leitfaden
      • ERSTE SCHRITTE

        • Aufgabeneditor
        • Rahmen
          • Canvas Frame
          • Seitenrahmen
          • Website-Rahmen
          • Überlagerungen & Dialoge | Labvanced
        • Versuchszeitachse
        • Stimuluspräsentation
        • Korrektheit der Antwort
        • Objekte
        • Ereignisse
        • Variablen
        • Aufgabenassistent
        • Versuchssystem
        • Experimentielles Design
          • Eine Studie erstellen
          • Vorlagen in Labvanced importieren
          • Datenrahmen-Muster
          • Multi-User Experimentdesign
          • Längsschnitt-Experimentdesign
      • HERVORGEHOBENE THEMATIKEN

        • Randomisierung & Balance
        • Eye Tracking
          • Präsentation von Stimuli in einer Augenverfolgungsaufgabe
          • Wie man die Einstellungen zur Augenverfolgung Kalibrierung wählt
          • Einrichtung der Augenverfolgung in einer Aufgabe
          • Aufnahme und Export von Blickdaten
          • Verwendung von Formen als Interessensgebiete (AOI) für das Eye Tracking
          • Die Erfahrung der Kalibrierung für Teilnehmer
        • Web-Brücke
          • Auswählen von Website-AOIs | Ankern, Anpassen und Überprüfen der AOI-Verfolgung
          • Verfolgen des Mausverhaltens auf einer Website AOI | Web Bridge Anleitung
        • Fragebögen
        • Desktop-App
        • Beispielstudien
        • Teilnehmerrekrutierung
        • API-Zugriff
          • REST API
          • Webhook-API
          • WebSocket API
        • Sonstige Themen

          • Präzise Stimuluszeitpunkte
          • Multi-User-Studien
          • Kopfverfolgung in Labvanced | Anleitung
      • HAUPT-APP-TABS

        • Überblick: Haupt-Tabs
        • Dashboard
        • Meine Studien
        • Geteilte Studien
        • Meine Dateien
        • Experimentbibliothek
        • Mein Konto
        • Lizenz & Dienstleistungen
      • STUDIENTABS

        • Überblick: Studien-spezifische Tabs
        • Studiendesign
          • Aufgaben
          • Blöcke
          • Sitzungen
          • Gruppen
        • Aufgabeneditor
          • Aufgabensteuerungen
          • Das Versuchs-System
          • Frame-Typen
          • Objekte
          • Objekt-Eigenschaftstabellen
          • Variablen
          • Systemvariablen-Tabelle
          • Das Ereignissystem
          • Texteditor-Funktionen
          • Optionen für Eye Tracking im Aufgabeneditor
          • Gesichtserkennung in einer Aufgabe
          • Multi-User-Studien
        • Einstellungen
        • Variablen
        • Medien
        • Texte & Übersetzen
        • Starten & Teilnehmen
        • Teilnehmerverwaltung
        • Datensicht und Export
    • Video-Tutorials
      • Video-Überblick
      • Erste Schritte mit Labvanced
      • Aufgaben erstellen
      • Element-Videos
      • Ereignisse & Variablen
      • Fortgeschrittene Themen
    • Anleitungen
      • Einführung
      • Stroop-Aufgabe
      • Lexikalische Entscheidungsaufgabe
      • Posner-Blickverfolgungsaufgabe
      • Paradigma der Veränderungsblindheit
      • Augenbewegungstracking-Beispielstudie
      • Säuglings-Augenbewegungstracking-Studie
      • Aufmerksamkeitserfassung-Studie mit Mausbewegungstracking
      • Schnelle serielle visuelle Präsentation
      • ChatGPT-Studie
      • Augenbewegungstracking-Demo: SVGs als AOIs
      • Multi-User-Demo: Zeigen Sie die Cursors der Probanden
      • Gamepad- / Joystick-Controller - Grundlegende Einrichtung
      • Desktop-App-Studie mit EEG-Integration
      • Gruppenbalance und Variablen-Setup zwischen den Probanden
      • Bau einer Multi-User-Studie
      • Website-Frame-Augenbewegungstracking-Anleitung
      • Bedingtes Webcam-Augenbewegungstracking
      • Textsegmentierungsstudie aufbauen
      • Aufbau einer Studie mit KI
    • FAQ
      • Funktionen
      • Support-Richtlinien & Leitlinien
      • Sicherheit & Datenschutz
      • Lizenzierung
      • Genauigkeit von Labvanced
      • Programmgesteuerte Nutzung & API
      • Labvanced offline nutzen
      • Fehlerbehebung
      • Fragen zur Studieneinrichtung

    REST API

    Labvanced bietet eine REST API, mit der Benutzer Daten vom Labvanced-Server abrufen können, nachdem die Teilnehmer die Studie abgeschlossen haben.

    Die REST API ist mit einem Token authentifiziert, das Ihnen ermöglicht, all Ihre Daten programmgesteuert herunterzuladen. Die REST API ist hervorragend für Organisationen und akademische Forschungseinrichtungen geeignet, die ihre Datenerfassung zentralisieren und ihre Daten gemäß ihrem Pipeline-Protokoll an dedizierten Orten speichern möchten. Anstatt Daten manuell auszuwählen und lokal zu speichern, ermöglicht dies Organisationen, auf die Daten auf ihren Servern zuzugreifen, was auch für das GDPR-Protokoll wichtig ist.

    Die Dokumentation (Swagger UI) der REST-Endpunkte finden Sie hier: https://www.labvanced.com/openapi.html

    Wir bieten auch eine OpenAPI-Spezifikation an, die verwendet werden kann, um Client-Code für verschiedene Programmiersprachen automatisch zu generieren (z. B. in Tools wie Postman): https://www.labvanced.com/labvanced-openapi.json

    Erstellen des API-Tokens

    Dies ist eine gesicherte API, was bedeutet, dass Sie den Zugriff mit einem in Labvanced generierten Token validieren müssen, um auf die Daten zuzugreifen.

    Um das Token zu erstellen, melden Sie sich in der Labvanced-App an und gehen Sie zum Tab "Mein Konto", der sich auf der linken Seite des Menüs befindet.

    Es gibt einen Abschnitt namens "API-Anmeldeinformationen", und um das Token zu erstellen, klicken Sie einfach auf "Generieren."

    indicating the button that generates the REST API

    Wenn das Token angezeigt wird, doppelklicken Sie auf den Token-Schlüssel, um ihn vollständig hervorzuheben, und drücken dann Ctrl+C, um ihn zu kopieren.

    Mit diesem Token können Sie auf die Daten Ihrer Studien und der relevanten Sitzungen zugreifen.

    Hinweis: Das Token kann nur vom Studienbesitzer generiert werden, um Zugriff auf die Sitzungsdaten zu gewähren.

    Testen Sie es mit unserer API-Dokumentation (Swagger UI)

    Die einfachste Möglichkeit, unsere API auszuprobieren, besteht darin, die Funktion "Try it out" in unserer API-Dokumentation (Swagger UI) zu verwenden: https://www.labvanced.com/openapi.html

    In der oberen rechten Ecke klicken Sie auf "Autorisieren".

    indicating the 'Authorize' button for inputting the REST API

    Dies öffnet ein Dialogfeld, in dem Sie aufgefordert werden, das Token im Feld "Wert" einzugeben / einzufügen.

    Dialog box for inputting the REST API credentials

    Nachdem Sie das Token eingefügt haben, klicken Sie auf "Autorisieren" und dann auf "Schließen", um das Dialogfeld zu schließen.

    Hinweis: Wenn Sie mit der Datenanzeige fertig sind, können Sie sich von dieser Sitzung abmelden, indem Sie auf "Autorisieren" in der oberen rechten Ecke der Website klicken und dann im angezeigten Dialogfeld auf die Schaltfläche "Abmelden" in der unteren linken Ecke klicken.

    Testen Sie den Zugriff auf Daten über unsere API-Dokumentation

    Sobald Sie angemeldet sind, können Sie diese beiden Bereiche nutzen, um auf Ihre experimentellen Daten zuzugreifen:

    Data options from the REST API for accessing sessions and participant data

    • /api/{expId}/download/{recSessionId}: Dieser Abschnitt ermöglicht es Ihnen, die Daten eines einzelnen Teilnehmers abzurufen und herunterzuladen. Wenn die Daten heruntergeladen werden, erfolgt dies im .csv-Dateiformat gemäß der Konfiguration, die Sie in den exportSettings auf der „Dataview & Export“-Seite in der Labvanced-App angegeben haben.
    • /api/{expId}/sessions: Ermöglicht es Ihnen, alle Sitzungen für ein bestimmtes Experiment abzurufen, indem Sie die „Experiment-ID“ eingeben.

    Daten von ‘/api/{expId}/sessions’

    Es ist am besten, mit dem zweiten Endpunkt zu beginnen, um zuerst herauszufinden, welche Aufzeichnungssitzungen (und deren entsprechende rec_session_id) in einem bestimmten Experiment existieren. Klicken Sie auf das zweite blaue Feld mit der Bezeichnung /api/{expId}/sessions und es wird in einer größeren Ansicht geöffnet, und klicken Sie auf die Schaltfläche "Try it out" auf der rechten Seite:

    Dialog box for fetching experiment data with the REST API based on the session id

    Durch Klicken auf "Try it out" können Sie Zahlen ins Feld "expid" eingeben, um die Experiment-ID anzugeben, für die Sie auf die Sitzungsdaten zugreifen möchten. Sie finden dies in Labvanced auf der Seite "Meine Studien" in der Spalte "ID". Sobald Sie dieses Feld ausgefüllt haben, klicken Sie auf "Ausführen".

    Sobald Sie dies getan haben, können Sie nach unten scrollen und die Informationen zu allen Sitzungen in diesem spezifischen Experiment sehen:

    Example of session data generated using the REST API

    Bitte notieren Sie sich eine der rec_session_id aus der Antwortnutzlast, um sie im nächsten Abschnitt zu verwenden, um alle aufgezeichneten Daten dieser Aufzeichnungssitzung herunterzuladen.

    Hinweis: Um eine andere „Experiment-ID“ einzugeben, klicken Sie einfach auf die rote Schaltfläche "Abbrechen" auf der rechten Seite, um eine neue „Experiment-ID“ eingeben zu können.

    Daten von ‘recSessionId’

    Um auf die Daten eines Teilnehmers zuzugreifen und diese herunterzuladen, klicken Sie auf das erste blaue Feld mit der Bezeichnung /api/{expId}/download/{recSessionId} und es wird in einer größeren Ansicht geöffnet, und klicken Sie auf die Schaltfläche "Try it out" auf der rechten Seite:

    Dialog for specifying the experiment id and session numbers for fetching data via the REST API

    Durch Klicken auf "Try it out" können Sie Zahlen in die beiden Felder eingeben, die erscheinen, indem Sie die „Experiment-ID“ und die „rec_session_id“ angeben, die Sie herunterladen möchten (siehe vorheriger Abschnitt).

    Sobald Sie diese Werte eingegeben haben, klicken Sie einfach auf "Ausführen" und die API wird ausgeführt. Dann scrollen Sie nach unten und Sie sehen eine Option zum 'Herunterladen der Datei.'

    Downloading files generated by the REST API

    Wenn Sie auf "Datei herunterladen" klicken, wird eine .zip heruntergeladen, die zwei .csv-Dateien enthält, nämlich:

    • sessions.csv
    • trials.csv

    Diese Dateien enthalten alle relevanten Daten für die spezifische Sitzung und die zugehörigen Versuchsdatendaten.

    Hinweis: Um eine andere Sitzung abzurufen, klicken Sie einfach auf die rote Schaltfläche "Abbrechen" auf der rechten Seite, um eine neue „Experiment-ID“ und eine neue „rec_session_id“ zum Herunterladen eingeben zu können.

    Zusammenfassend ermöglichen Ihnen diese Schritte, Daten mit dem API-Token abzurufen, das Sie mit einem eindeutigen und gesicherten Token in Labvanced generiert haben, um experimentelle und Sitzungsdaten anzuzeigen.

    Testen Sie es mithilfe von Postman

    Dies ist eine zweite Option, um die API auszuprobieren, für diejenigen, die Postman (eine API-Plattform) bereits in ihren täglichen Aktivitäten verwenden. Das Labvanced API-Token funktioniert auch dort.

    Geben Sie die URL im oberen Feld ein, basierend auf der Labvanced API-Website.

    Wählen Sie dann den Schlüssel aus und fügen Sie das Token unter der Spalte "Wert" ein, wie unten gezeigt:

    Demonstration of how to use POSTMAN with the Labvanced-generated REST API

    Auf diese Weise wird der Sitzungsdaten für ein Experiment über Postman zugänglich sein.

    Ebenso können Sie denselben Prozess befolgen, um Dateien für einen bestimmten Teilnehmer herunterzuladen.

    Wenn Sie dies tun, zeigt die Vorschau seltsame Zeichen an, aber das ist normal, da dieses Kommando zum Abrufen von Dateien dient. Wenn Sie auf "Antworten speichern" und "In eine Datei speichern" klicken, erscheinen die Daten für den jeweiligen Teilnehmer normal.

    Demonstration of how file-based data appears in POSTMAN with the Labvanced REST API

    Next
    Webhook-API