Search Identities | Resemble

POST https://app.resemble.ai/api/v2/identity/search

Search for matching voice identities based on an audio sample.

Request Body

Field	Type	Required	Description
`url`	string	✅	URL to audio sample to search for.
`top_k`	integer	❌	Number of top matches to return (1-20). Default: 5.

Example Request

$ curl --request POST 'https://app.resemble.ai/api/v2/identity/search' \
>   -H 'Authorization: Bearer YOUR_API_TOKEN' \
>   -H 'Content-Type: application/json' \
>   --data '{
>     "url": "https://example.com/audio/sample_to_search.wav",
>     "top_k": 5
>   }'

Response

1 {
2   "success": true,
3   "item": [
4     {
5       "uuid": "IDENTITY_UUID",
6       "name": "John Doe",
7       "confidence": 0.95,
8       "distance": 0.12
9     },
10     {
11       "uuid": "IDENTITY_UUID_2",
12       "name": "Jane Smith",
13       "confidence": 0.87,
14       "distance": 0.24
15     }
16   ]
17 }

Note: Returns the top K most similar speakers, sorted by similarity.

$	curl --request POST 'https://app.resemble.ai/api/v2/identity/search' \
>	-H 'Authorization: Bearer YOUR_API_TOKEN' \
>	-H 'Content-Type: application/json' \
>	--data '{
>	"url": "https://example.com/audio/sample_to_search.wav",
>	"top_k": 5
>	}'

1	{
2	"success": true,
3	"item": [
4	{
5	"uuid": "IDENTITY_UUID",
6	"name": "John Doe",
7	"confidence": 0.95,
8	"distance": 0.12
9	},
10	{
11	"uuid": "IDENTITY_UUID_2",
12	"name": "Jane Smith",
13	"confidence": 0.87,
14	"distance": 0.24
15	}
16	]
17	}