---
title: "Get Similar Library Voices"
method: POST
path: "/v1/similar-voices"
tags: ["voices"]
---

# Get Similar Library Voices

`POST /v1/similar-voices`

Returns a list of shared voices similar to the provided audio sample. If neither similarity_threshold nor top_k is provided, we will apply default values.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- GetLibraryVoicesResponseModel
  - `voices` LibraryVoiceResponseModel[], required — The list of shared voices
    - `public_owner_id` string, required — The public owner id of the voice.
    - `voice_id` string, required — The id of the voice.
    - `date_unix` integer, required — The date the voice was added to the library in Unix time.
    - `name` string, required — The name of the voice.
    - `accent` string, required — The accent of the voice.
    - `gender` string, required — The gender of the voice.
    - `age` string, required — The age of the voice.
    - `descriptive` string, required — The descriptive of the voice.
    - `use_case` string, required — The use case of the voice.
    - `category` 'generated' | 'cloned' | 'premade' | 'professional' | 'famous' | 'high_quality', required — The category of the voice.
    - `language` string, nullable — The language of the voice.
    - `locale` string, nullable — The locale of the voice.
    - `description` string, nullable — The description of the voice.
    - `preview_url` string, nullable — The preview URL of the voice.
    - `usage_character_count_1y` integer, required — The usage character count of the voice in the last year.
    - `usage_character_count_7d` integer, required — The usage character count of the voice in the last 7 days.
    - `play_api_usage_character_count_1y` integer, required — The play API usage character count of the voice in the last year.
    - `cloned_by_count` integer, required — The number of times the voice has been cloned.
    - `rate` number, nullable — The rate multiplier of the voice.
    - `fiat_rate` number, nullable — The rate of the voice in USD per 1000 credits. null if default
    - `free_users_allowed` boolean, required — Whether free users are allowed to use the voice.
    - `live_moderation_enabled` boolean, required — Whether live moderation is enabled for the voice.
    - `featured` boolean, required — Whether the voice is featured.
    - `verified_languages` VerifiedVoiceLanguageResponseModel[], nullable — The verified languages of the voice.
      - `language` string, required — The language of the voice.
      - `model_id` string, required — The voice's model ID.
      - `accent` string, nullable — The voice's accent, if applicable.
      - `locale` string, nullable — The voice's locale, if applicable.
      - `preview_url` string, nullable — The voice's preview URL, if applicable.
    - `notice_period` integer, nullable — The notice period of the voice.
    - `instagram_username` string, nullable — The Instagram username of the voice.
    - `twitter_username` string, nullable — The Twitter username of the voice.
    - `youtube_username` string, nullable — The YouTube username of the voice.
    - `tiktok_username` string, nullable — The TikTok username of the voice.
    - `image_url` string, nullable — The image URL of the voice.
    - `is_added_by_user` boolean, nullable — Whether the voice was added by the user.
    - `is_bookmarked` boolean, nullable — Whether the voice is bookmarked by the current user. Only relevant when is_added_by_user is True.
  - `has_more` boolean, required — Whether there are more shared voices in subsequent pages.
  - `total_count` integer — The total number of shared voices matching the query.
  - `last_sort_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/1a31d01a1fb9/schema)