Safety & DetectionIdentity API

Search Identities

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

Search for matching voice identities based on an audio sample.

Request Body

FieldTypeRequiredDescription
urlstring✅URL to audio sample to search for.
top_kinteger❌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.