Get shared voices

GET

/v1/shared-voices

Retrieves a list of shared voices.

Query parameters

page_sizeintegerOptionalDefaults to 30

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

categoryenumOptional

Voice category used for filtering

Allowed values: professionalfamoushigh_quality

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

featuredbooleanOptionalDefaults to false

Filter featured voices

min_notice_period_daysintegerOptional

Filter voices with a minimum notice period of the given number of days.

reader_app_enabledbooleanOptionalDefaults to false

Filter voices that are enabled for the reader app

owner_idstringOptional

Filter voices by public owner ID

sortstringOptional

Sort criteria

pageintegerOptionalDefaults to 0

Response

Successful Response

voiceslist of objects

The list of shared voices

has_moreboolean

Whether there are more shared voices in subsequent pages.

last_sort_idstringOptional

Errors

GET

1 curl -G https://api.elevenlabs.io/v1/shared-voices \
2      -H "xi-api-key: <apiKey>" \
3      -d gender=male \
4      -d age=young \
5      -d accent=american \
6      -d language=en \
7      -d search=tiktok \
8      -d featured=true \
9      -d min_notice_period_days=30 \
10      -d reader_app_enabled=true \
11      -d owner_id=7c9fab611d9a0e1fb2e7448a0c294a8804efc2bcc324b0a366a5d5232b7d1532 \
12      -d sort=created_date

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": "professional",
14       "usage_character_count_1y": 12852,
15       "usage_character_count_7d": 12852,
16       "play_api_usage_character_count_1y": 12852,
17       "cloned_by_count": 11,
18       "free_users_allowed": true,
19       "live_moderation_enabled": false,
20       "featured": false,
21       "language": "en",
22       "description": "Perfectly calm, neutral and strong voice. Great for a young female protagonist.",
23       "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3",
24       "rate": 1,
25       "verified_languages": [
26         {
27           "language": "en",
28           "model_id": "eleven_turbo_v2_5",
29           "accent": "American"
30         }
31       ],
32       "notice_period": 1,
33       "instagram_username": "instagram_username",
34       "twitter_username": "twitter_username",
35       "youtube_username": "youtube_username",
36       "tiktok_username": "tiktok_username",
37       "image_url": "image_url",
38       "is_added_by_user": true
39     }
40   ],
41   "has_more": false,
42   "last_sort_id": "last_sort_id"
43 }

Add shared voice

Up Next

Built with

1	curl -G https://api.elevenlabs.io/v1/shared-voices \
2	-H "xi-api-key: <apiKey>" \
3	-d gender=male \
4	-d age=young \
5	-d accent=american \
6	-d language=en \
7	-d search=tiktok \
8	-d featured=true \
9	-d min_notice_period_days=30 \
10	-d reader_app_enabled=true \
11	-d owner_id=7c9fab611d9a0e1fb2e7448a0c294a8804efc2bcc324b0a366a5d5232b7d1532 \
12	-d sort=created_date

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": "professional",
14	"usage_character_count_1y": 12852,
15	"usage_character_count_7d": 12852,
16	"play_api_usage_character_count_1y": 12852,
17	"cloned_by_count": 11,
18	"free_users_allowed": true,
19	"live_moderation_enabled": false,
20	"featured": false,
21	"language": "en",
22	"description": "Perfectly calm, neutral and strong voice. Great for a young female protagonist.",
23	"preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3",
24	"rate": 1,
25	"verified_languages": [
26	{
27	"language": "en",
28	"model_id": "eleven_turbo_v2_5",
29	"accent": "American"
30	}
31	],
32	"notice_period": 1,
33	"instagram_username": "instagram_username",
34	"twitter_username": "twitter_username",
35	"youtube_username": "youtube_username",
36	"tiktok_username": "tiktok_username",
37	"image_url": "image_url",
38	"is_added_by_user": true
39	}
40	],
41	"has_more": false,
42	"last_sort_id": "last_sort_id"
43	}