Search Identities

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

Search for matching voice identities based on an audio sample.

Request Body

FieldTypeRequiredDescription
urlstringURL to audio sample to search for.
top_kintegerNumber 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.