GET
/
v1
/
shared-voices
curl --request GET \
  --url https://api.elevenlabs.io/v1/shared-voices
{
  "voices": [
    {
      "public_owner_id": "<string>",
      "voice_id": "<string>",
      "date_unix": 123,
      "name": "<string>",
      "accent": "<string>",
      "gender": "<string>",
      "age": "<string>",
      "descriptive": "<string>",
      "use_case": "<string>",
      "category": "<string>",
      "language": "<string>",
      "description": "<string>",
      "preview_url": "<string>",
      "usage_character_count_1y": 123,
      "usage_character_count_7d": 123,
      "play_api_usage_character_count_1y": 123,
      "cloned_by_count": 123,
      "rate": 123,
      "free_users_allowed": true,
      "live_moderation_enabled": true,
      "featured": true,
      "notice_period": 123,
      "instagram_username": "<string>",
      "twitter_username": "<string>",
      "youtube_username": "<string>",
      "tiktok_username": "<string>"
    }
  ],
  "has_more": true,
  "last_sort_id": "<string>"
}

Headers

xi-api-key
string

Your API key. This is required by most endpoints to access our API programatically. You can view your xi-api-key using the 'Profile' tab on the website.

Query Parameters

page_size
integer
default: 30

How many shared voices to return at maximum. Can not exceed 100, defaults to 30.

category
string

voice category used for filtering

gender
string

gender used for filtering

age
string

age used for filtering

accent
string

accent used for filtering

language
string

language used for filtering

search
string

search term used for filtering

use_cases
string[]

use-case used for filtering

descriptives
string[]

search term used for filtering

featured
boolean
default: false

Filter featured voices

reader_app_enabled
boolean
default: false

Filter voices that are enabled for the reader app

owner_id
string

Filter voices by public owner ID

sort
string

sort criteria

page
integer
default: 0

Response

200 - application/json
voices
object[]
required
has_more
boolean
required
last_sort_id
string