---
title: "Extract the full openSMILE eGeMAPSv02 feature set (88 features) from a previously uploaded audio file. Files longer t…"
method: GET
path: "/api/gemaps-extract"
tags: ["Audio Measures"]
---

# Extract the full openSMILE eGeMAPSv02 feature set (88 features) from a previously uploaded audio file. Files longer t…

`GET /api/gemaps-extract`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/gemaps-extract`
- Auth: API key in header `X-API-Key`

## Query parameters

- `fileId` string, required

## Response `200`

Successful response

- object
  - `<eGeMAPSv02 features>` object: The full eGeMAPSv02 feature object (88 features) as emitted by openSMILE — feature names follow the openSMILE convention (e.g. F0semitoneFrom27.5Hz_sma3nz_amean, loudness_sma3_amean, jitterLocal_sma3nz_amean, shimmerLocaldB_sma3nz_amean, HNRdBACF_sma3nz_amean, F1frequency_sma3nz_amean, etc.). Refer to the openSMILE eGeMAPSv02 configuration for the canonical key list — this server is a transparent wrapper around it.
  - `chunk_info` object: Object describing chunking: `{ total_chunks: number, current_chunk: number, start_time: number, duration: number, is_chunked: boolean }`. For files ≤ 8 s, is_chunked is false and the whole file produces one result.
  - `metadata` object: Object: `{ file_id: string, processing_duration_seconds: number, analysis_type: "single_chunk" | "chunked" }`.

## Other responses

- `400`: Bad request — missing or invalid parameter
- `401`: Unauthorized — missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Server error

---

[API](https://skmtc.dev/vocametrix/apis/vocametrix-api.md) · [All operations](https://skmtc.dev/vocametrix/apis/vocametrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vocametrix/apis/vocametrix-api/revisions/8a54d01bcc81?raw)