--- title: "Get Similar Library Voices" method: POST path: "/v1/similar-voices" tags: ["voices"] --- # Get Similar Library Voices `POST /v1/similar-voices` ## Request - Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.elevenlabs.io/v1/similar-voices` - Auth: none declared 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. ## Request body `multipart/form-data` - BodyGetSimilarLibraryVoicesV1SimilarVoicesPost - `audio_file` string, binary - `similarity_threshold` number, nullable: Threshold for voice similarity between provided sample and library voices. Values range from 0 to 2. The smaller the value the more similar voices will be returned. - `top_k` integer, nullable: Number of most similar voices to return. If similarity_threshold is provided, less than this number of voices may be returned. Values range from 1 to 100. ## 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 ## Changes - **2026-04-03** `deb5e58ddddf`: 2 info - added the optional property `total_count` to the response with the `200` status - added the optional property `voices/items/is_bookmarked` to the response with the `200` status - **2026-02-08** `5b595807512c`: 1 info - api operation id `Get_similar_library_voices_v1_similar_voices_post` removed and replaced with `get_similar_library_voices` - **2025-05-16** `503db4198a44`: 15 breaking, 8 info - the response property `voices/items/description` became optional for the status `200` - the response property `voices/items/language` became optional for the status `200` - the response property `voices/items/preview_url` became optional for the status `200` - the response property `voices/items/rate` became optional for the status `200` - …19 more - **2024-09-12** `fcd0e891f408`: 6 warning - added the new `cloned` enum value to the `voices/items/category` response property for the response status `200` - added the new `famous` enum value to the `voices/items/category` response property for the response status `200` - added the new `generated` enum value to the `voices/items/category` response property for the response status `200` - added the new `high_quality` enum value to the `voices/items/category` response property for the response status `200` - …2 more - **2024-08-28** `0f0a2b37eafb`: 1 info - endpoint added [Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/similar-voices/post.md) --- [API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)