Search Voices
Search voices with various keywords and filters.
Search Voices API allows you to find the perfect voice for your needs using various filtering and sorting options. This guide explains how to effectively use the search parameters to narrow down your results.
Basic Usage
To search for voices, make a GET request to /v1/voices/search
. You can use multiple parameters to filter and sort the results.
Search Logic
- Multiple values within the same parameter are combined with OR logic (comma-separated)
- Different parameters are combined with AND logic
- If no parameters are provided, returns the first page with 20 voices sorted by name ascending
Available Parameters
Filter Parameters
language
- Available options:
ko
,ja
,en
- Example:
language=en,ko
(searches for voices in English OR Korean)
gender
- Available options:
male
,female
- Example:
gender=male,female
age
- Available options:
child
,young-adult
,middle-aged
,elder
- Example:
age=young-adult,middle-aged
use_case
- Available options:
advertisement
,announcement
,audiobook
,documentary
,education
,game
- Example:
use_case=game,advertisement
search
- Searches across name and description fields
- Uses space-separated keywords with AND logic
- Example:
search=calm professional
Pagination
page
- Starting from 0
- Default: 0
page_size
- Range: 1-100
- Default: 20
Sorting
sort
- Default:
name:asc
- Available options:
name:asc
,name:desc
age:asc
,age:desc
use_case:asc
,use_case:desc
language:asc
,language:desc
gender:asc
,gender:desc
Example Requests
Response Format
The API returns a JSON response containing:
- List of matching voices
- Total count of matches
- Current page number
- Page size
- Total number of pages
Example Response
Headers
API key for the service
Query Parameters
Search across name and description
Filter by language (comma-separated)
Filter by gender (comma-separated)
Filter by age (comma-separated)
Filter by use case (comma-separated)
Filter by style (comma-separated)
Page number (default: 0)
Number of items per page (default: 20, max: 100)
Sorting criteria (default: name:asc)