Get Voices

GET

/v1/shared-voices

Gets a list of shared voices.

Query parameters

page_sizeintegerOptional

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

categorystringOptional

voice category used for filtering

genderstringOptional

gender used for filtering

agestringOptional

age used for filtering

accentstringOptional

accent used for filtering

languagestringOptional

language used for filtering

searchstringOptional

search term used for filtering

use_casesstringOptional

use-case used for filtering

descriptivesstringOptional

search term used for filtering

featuredbooleanOptional

Filter featured voices

reader_app_enabledbooleanOptional

Filter voices that are enabled for the reader app

owner_idstringOptional

Filter voices by public owner ID

sortstringOptional

sort criteria

pageintegerOptional

Response

Successful Response

voiceslist of objects

has_moreboolean

last_sort_idstringOptional

GET

1 curl -G https://api.elevenlabs.io/v1/shared-voices \
2      -H "xi-api-key: <apiKey>" \
3      -d page_size=1 \
4      -d gender=female \
5      -d language=en

200Retrieved

1 {
2   "voices": [
3     {
4       "public_owner_id": "63e84100a6bf7874ba37a1bab9a31828a379ec94b891b401653b655c5110880f",
5       "voice_id": "sB1b5zUrxQVAFl2PhZFp",
6       "date_unix": 1714423232,
7       "name": "Alita",
8       "accent": "american",
9       "gender": "female",
10       "age": "young",
11       "descriptive": "calm",
12       "use_case": "characters_animation",
13       "category": "generated",
14       "language": "en",
15       "description": "Perfectly calm, neutral and strong voice. Great for a young female protagonist.",
16       "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3",
17       "usage_character_count_1y": 12852,
18       "usage_character_count_7d": 12852,
19       "play_api_usage_character_count_1y": 12852,
20       "cloned_by_count": 11,
21       "rate": 1,
22       "free_users_allowed": true,
23       "live_moderation_enabled": false,
24       "featured": false
25     }
26   ],
27   "has_more": true
28 }

Add Sharing Voice

Up Next

Built with

1	curl -G https://api.elevenlabs.io/v1/shared-voices \
2	-H "xi-api-key: <apiKey>" \
3	-d page_size=1 \
4	-d gender=female \
5	-d language=en

1	{
2	"voices": [
3	{
4	"public_owner_id": "63e84100a6bf7874ba37a1bab9a31828a379ec94b891b401653b655c5110880f",
5	"voice_id": "sB1b5zUrxQVAFl2PhZFp",
6	"date_unix": 1714423232,
7	"name": "Alita",
8	"accent": "american",
9	"gender": "female",
10	"age": "young",
11	"descriptive": "calm",
12	"use_case": "characters_animation",
13	"category": "generated",
14	"language": "en",
15	"description": "Perfectly calm, neutral and strong voice. Great for a young female protagonist.",
16	"preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3",
17	"usage_character_count_1y": 12852,
18	"usage_character_count_7d": 12852,
19	"play_api_usage_character_count_1y": 12852,
20	"cloned_by_count": 11,
21	"rate": 1,
22	"free_users_allowed": true,
23	"live_moderation_enabled": false,
24	"featured": false
25	}
26	],
27	"has_more": true
28	}