Search Voices

client.voices.search(
    next_page_token: Optional[str] = None,
    page_size: Optional[int] = None,
    search: Optional[str] = None,
    sort: Optional[str] = None,
    sort_direction: Optional[str] = None,
    voice_type: Optional[str] = None,
    category: Optional[str] = None,
    fine_tuning_state: Optional[str] = None,
    collection_id: Optional[str] = None,
    include_total_count: Optional[bool] = None,
    voice_ids: Optional[Union[str, Sequence[str]]] = None,
    request_options: Optional[RequestOptions] = None
) -> GetVoicesV2Response

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

response = client.voices.search()
print(f"Found {len(response.voices)} voices")
for voice in response.voices:
    print(f"- {voice.name} ({voice.voice_id})")

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

response = client.voices.search(
    category="cloned",
    page_size=20,
    sort="created_at_unix",
    sort_direction="desc"
)

print(f"Found {response.total_count} cloned voices")
for voice in response.voices:
    print(f"- {voice.name}: {voice.description}")

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

response = client.voices.search(
    search="british accent",
    voice_type="default"
)

for voice in response.voices:
    print(f"Found: {voice.name}")
    if voice.labels:
        print(f"  Labels: {voice.labels}")

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

all_voices = []
next_token = None

while True:
    response = client.voices.search(
        next_page_token=next_token,
        page_size=100
    )
    
    all_voices.extend(response.voices)
    
    if not response.has_more:
        break
    
    next_token = response.next_page_token

print(f"Retrieved {len(all_voices)} total voices")

from elevenlabs import ElevenLabs

client = ElevenLabs(api_key="YOUR_API_KEY")

voice_ids = [
    "21m00Tcm4TlvDq8ikWAM",
    "AZnzlk1XvdvUeBnXmlld",
    "EXAVITQu4vr4xnSDxMaL"
]

response = client.voices.search(voice_ids=voice_ids)

for voice in response.voices:
    print(f"{voice.voice_id}: {voice.name}")