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
    • JA
      • 中國人
      • 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
    • 日本語
    • はじめに
    • ガイド
      • はじめに

        • タスクエディタ
        • フレーム
          • キャンバスフレーム
          • ページフレーム
          • ウェブサイトフレーム
          • オーバーレイとダイアログ | Labvanced
        • トライアルタイムライン
        • 刺激提示
        • 応答の正確性
        • オブジェクト
        • イベント
        • 変数
        • タスクウィザード
        • AIアシスタント
        • トライアルシステム
        • 実験設計
          • 研究の作成
          • Labvancedでのテンプレートのインポート
          • データフレームパターン
          • マルチユーザー実験デザイン
          • 縦断実験デザイン
      • 注目のトピック

        • ランダム化とバランス
        • アイ・トラッキング
          • 注視追跡タスクにおける刺激の提示
          • 眼球追跡キャリブレーション設定の選択方法
          • タスクにおける視線追跡の設定
          • 注視データの記録とエクスポート
          • 形状を興味領域 (AOI) として使用する方法
          • 参加者キャリブレーション体験
        • ウェブブリッジ
          • ウェブサイト AOI の選択 | アンカー、調整、および AOI トラッキングの検証
          • ウェブサイト AOI におけるマウスの動作の追跡 | ウェブブリッジガイド
        • アンケート
        • デスクトップアプリ
        • サンプル研究
        • 参加者募集
        • APIアクセス
          • REST API
          • Webhook API
          • WebSocket API
        • その他のトピック

          • 正確な刺激のタイミング
          • マルチユーザー研究
          • Labvancedにおける頭追跡 | ガイド
      • メインアプリタブ

        • 概要: メインタブ
        • ダッシュボード
        • 私の研究
        • 共有研究
        • 私のファイル
        • 実験ライブラリ
        • 私のアカウント
        • ライセンスとサービス
      • 研究タブ

        • 概要: 研究特有のタブ
        • 研究デザイン
          • タスク
          • ブロック
          • セッション
          • グループ
        • タスクエディタ
          • タスクコントロール
          • 試行システム
          • フレームタイプ
          • オブジェクト
          • オブジェクトプロパティテーブル
          • 変数
          • システム変数表
          • イベントシステム
          • テキストエディタの機能
          • タスクエディタにおける視線追跡オプション
          • タスクにおけるヘッドトラッキング
          • マルチユーザー研究
        • 設定
        • 変数
        • メディア
        • テキストと翻訳
        • 開始と参加
        • 被験者管理
        • データビューとエクスポート
    • ビデオチュートリアル
      • ビデオ概要
      • Labvancedの始め方
      • タスクの作成
      • エレメントビデオ
      • イベントと変数
      • 高度なトピック
    • ウォークスルー
      • イントロダクション
      • ストループタスク
      • 語彙的意思決定タスク
      • ポズナー注視キューイングタスク
      • 変化盲目的フリッカーのパラダイム
      • 眼球追跡サンプル研究
      • 乳児眼球追跡研究
      • マウストラッキングによる注意捕捉研究
      • 迅速な連続視覚提示
      • ChatGPT研究
      • 眼球追跡デモ:AOIとしてのSVG
      • マルチユーザーデモ:被験者のカーソルを表示
      • ゲームパッド / ジョイスティックコントローラ - 基本設定
      • EEG統合付きデスクトップアプリ研究
      • 被験者間グループのバランスと変数設定
      • マルチユーザー研究の構築
      • ウェブサイトフレーム眼球追跡ウォークスルー
      • 条件付きウェブカメラ眼球追跡
      • テキストセグメンテーション研究の構築
      • AIを使った研究の構築
    • FAQ
      • 機能
      • サポートポリシーとガイドライン
      • セキュリティとデータプライバシー
      • ライセンス
      • Labvancedの精度
      • プログラマティック使用とAPI
      • Labvancedをオフラインで使用する
      • トラブルシューティング
      • 研究作成に関する質問

    REST API

    Labvanced は、参加者が研究を完了した後に Labvanced サーバーからデータを取得するための REST API を提供しています。

    REST API はトークンを使用して認証されており、すべてのデータをプログラムでダウンロードできます。REST API は、データの取得を集中化し、パイプラインプロトコルに従ってデータを特定の場所に保存したい組織や学術研究機関に最適です。手動でデータを選択してダウンロードし、ローカルに保存する代わりに、これにより組織は自社のサーバーでデータにアクセスでき、GDPR プロトコルにも重要です。

    REST エンドポイントのドキュメント (Swagger UI) はこちらでご覧いただけます: https://www.labvanced.com/openapi.html

    また、さまざまなプログラミング言語用のクライアントコードを自動生成するために使用できる OpenAPI 仕様も提供しています (例: Postman のようなツールで): https://www.labvanced.com/labvanced-openapi.json

    API トークンの作成

    これはセキュリティが確保された API であり、データにアクセスするためには Labvanced で生成されたトークンを使用してアクセスを検証する必要があります。

    トークンを作成するには、Labvanced アプリにログインし、メニューの左側にある「マイアカウント」タブに移動します。

    「API 認証情報」というセクションがあり、トークンを作成するには「生成」をクリックするだけです。

    indicating the button that generates the REST API

    トークンが表示されたら、そのトークンキーをダブルクリックして全てハイライトし、Ctrl+C でコピーします。

    このトークンを使用すると、あなたの研究と関連するセッションのデータにアクセスできます。

    注: トークンは、研究の所有者によってセッションデータへのアクセスを提供するためにのみ生成できます。

    API ドキュメント (Swagger UI) を使用した試行

    API を試す最も簡単な方法は、API ドキュメント (Swagger UI) の「試してみる」機能を利用することです: https://www.labvanced.com/openapi.html

    右上の「認証」をクリックします。

    indicating the 'Authorize' button for inputting the REST API

    これにより、トークンを「値」フィールドに入力または貼り付けするように求めるダイアログボックスが開きます。

    Dialog box for inputting the REST API credentials

    トークンを貼り付けたら、「認証」をクリックし、「閉じる」をクリックしてダイアログボックスを閉じます。

    注: データの表示が終わったら、ウェブサイト右上にある「認証」をクリックし、表示されるダイアログボックスで左下に表示される「ログアウト」ボタンをクリックすることで、このセッションからログアウトできます。

    API ドキュメントを使用したデータアクセスの試行

    ログインしたら、以下の二つのエリアを利用して実験データにアクセスできます:

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

    • /api/{expId}/download/{recSessionId}: このセクションでは、特定の参加者のデータにアクセスしてダウンロードできます。データをダウンロードすると、Labvanced アプリの ‘Dataview & Export’ ページにある exportSettings で指定した設定に基づいて、.csv ファイル形式で出力されます。
    • /api/{expId}/sessions: 「experiment id」を入力することで、特定の実験のすべてのセッションを取得できます。

    ‘/api/{expId}/sessions’ からのデータ

    最初に第二のエンドポイントを使用して、特定の実験内でどの録音セッション (およびそれに対応する rec_session_id) が存在するかを確認するのが最適です。 青色の /api/{expId}/sessions とラベルが付けられた第二のフィールドをクリックすると、大きなビューが開き、「試してみる」ボタンを右側でクリックします:

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

    「試してみる」をクリックすることで、セッションデータにアクセスしたい実験 ID を指定するために「expid」フィールドに数字を入力できます。これを Labvanced の「マイスタディ」ページの「ID」列で見つけることができます。このフィールドに入力したら、「実行」をクリックします。

    これを行うと、特定の実験のすべてのセッションの情報を下にスクロールして見ることができます:

    Example of session data generated using the REST API

    応答ペイロードから rec_session_id の一つをメモして、次のセクションでその録音セッションのすべての記録データをダウンロードするために使用してください。

    注: 異なる「experiment id」を入力したい場合は、右側の赤い「キャンセル」ボタンをクリックして、新しい「experiment id」を入力できるようにします。

    ‘recSessionId’ からのデータ

    参加者のデータにアクセスしてダウンロードするには、青色の /api/{expId}/download/{recSessionId} とラベルが付けられた最初のフィールドをクリックすると、大きなビューが開き、右側の「試してみる」ボタンをクリックします:

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

    「試してみる」をクリックすると、ダウンロードしたい「experiment id」と「rec_session_id」を指定する2つのフィールドに数字を入力できます (前のセクションを参照)。

    これらの値を入力したら、「実行」をクリックすると API が実行されます。下にスクロールすると、「ファイルをダウンロード」するオプションが表示されます。

    Downloading files generated by the REST API

    「ファイルをダウンロード」をクリックすると、2つの .csv ファイル、すなわち:

    • sessions.csv
    • trials.csv

    が含まれる .zip がダウンロードされます。

    これらのファイルには、特定のセッションと関連するトライアルデータに関するすべての関連データが含まれています。

    注: 異なるセッションを取得するには、右側の赤い「キャンセル」ボタンをクリックして、新しい「experiment id」と新しい「rec_session_id」を入力できるようにします。

    結論として、これらのステップにより、Labvanced で生成されたユニークでセキュアなトークンを使用してデータにアクセスし、実験データとセッションデータを表示できます。

    Postman を使用して試してみる

    これは、日常的に Postman (API プラットフォーム) を使用している人向けの API を試すための第二のオプションです。Labvanced API トークンは、そこでも機能します。

    Labvanced API ウェブサイトに基づいて、上部フィールドに URL を入力します。

    次に、キーを選択し、「値」列の下にトークンを貼り付けます。以下のようになります:

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

    この方法で、実験のセッションデータに Postman を通じてアクセスできます。

    同様のプロセスに従って、特定の参加者のファイルをダウンロードすることもできます。

    これを行うと、プレビューには奇妙な文字が表示されますが、これは正常です。このコマンドはファイルを取得するためのものであり、「レスポンスを保存」と「ファイルに保存」をクリックすると、特定の参加者のデータが正常に表示されます。

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

    Next
    Webhook API