List shared voices

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
async function main() {
    const client = new ElevenLabsClient({
        environment: "https://api.elevenlabs.io",
    });
    await client.voices.getShared({
        pageSize: 1,
        category: "professional",
        gender: "gender",
        age: "age",
        accent: "accent",
        language: "language",
        locale: "locale",
        search: "search",
        featured: true,
        minNoticePeriodDays: 1,
        includeCustomRates: true,
        includeLiveModerated: true,
        readerAppEnabled: true,
        ownerId: "owner_id",
        sort: "sort",
        page: 1,
    });
}
main();

{
  "voices": [
    {
      "public_owner_id": "63e84100a6bf7874ba37a1bab9a31828a379ec94b891b401653b655c5110880f",
      "voice_id": "sB1b5zUrxQVAFl2PhZFp",
      "date_unix": 1714423232,
      "name": "Alita",
      "accent": "american",
      "gender": "Female",
      "age": "young",
      "descriptive": "calm",
      "use_case": "characters_animation",
      "category": "professional",
      "usage_character_count_1y": 12852,
      "usage_character_count_7d": 12852,
      "play_api_usage_character_count_1y": 12852,
      "cloned_by_count": 11,
      "free_users_allowed": true,
      "live_moderation_enabled": false,
      "featured": false,
      "language": "en",
      "locale": "locale",
      "description": "Perfectly calm, neutral and strong voice. Great for a young female protagonist.",
      "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3",
      "rate": 1,
      "fiat_rate": 1.1,
      "verified_languages": [
        {
          "language": "en",
          "model_id": "eleven_multilingual_v2",
          "accent": "american",
          "locale": "en-US",
          "preview_url": "https://storage.googleapis.com/eleven-public-prod/wqkMCd9huxXHX1dy5mLJn4QEQHj1/voices/sB1b5zUrxQVAFl2PhZFp/55e71aac-5cb7-4b3d-8241-429388160509.mp3"
        }
      ],
      "notice_period": 1,
      "instagram_username": "instagram_username",
      "twitter_username": "twitter_username",
      "youtube_username": "youtube_username",
      "tiktok_username": "tiktok_username",
      "image_url": "image_url",
      "is_added_by_user": true
    }
  ],
  "has_more": false,
  "last_sort_id": "last_sort_id"
}

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:

genderstringOptional

Gender used for filtering

agestringOptional

Age used for filtering

accentstringOptional

Accent used for filtering

languagestringOptional

Language used for filtering

localestringOptional

Locale 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.

include_custom_ratesbooleanOptional

Include/exclude voices with custom rates

include_live_moderatedbooleanOptional

Include/exclude voices that are live moderated

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_idstring or null

Headers

Query parameters

Response

Errors