Smart search

GET

/v1/convai/conversations/messages/smart-search

GET

/v1/convai/conversations/messages/smart-search

$ curl -G https://api.elevenlabs.io/v1/convai/conversations/messages/smart-search \
>      -H "xi-api-key: 123e4567-e89b-12d3-a456-426614174000" \
>      -H "Content-Type: application/json" \
>      --data-urlencode "text_query=Customer asking to cancel and get money back" \
>      -d agent_id=agent_3701k3ttaq12ewp8b7qv5rfyszkz \
>      -d page_size=10 \
>      -d cursor=cursor

1 {
2   "results": [
3     {
4       "conversation_id": "conv_9f8b7a6c5d4e3f2a1b0c",
5       "agent_id": "agent_3701k3ttaq12ewp8b7qv5rfyszkz",
6       "transcript_index": 3,
7       "chunk_text": "I understand you want to cancel your subscription and receive a refund. Let me assist you with that process.",
8       "score": 0.92,
9       "conversation_start_time_unix_secs": 1685000000,
10       "agent_name": "Support Agent Jane",
11       "chunk_highlights": null
12     }
13   ],
14   "has_more": false,
15   "meta": {
16     "total": 1,
17     "page": 1,
18     "page_size": 10
19   },
20   "next_cursor": "cursor_eyJwYWdlIjoxfQ=="
21 }

Search conversation transcripts by semantic similarity to surface relevant messages based on meaning and intent, rather than exact keyword matches

Headers

xi-api-keystringOptional

Query parameters

text_querystringRequired

The search query text for semantic similarity matching

agent_idstringOptional

Agent id (agent_…) or speech engine external id (seng_), resolved to the same underlying resource.

page_sizeintegerOptional1-50Defaults to 20

Number of results per page. Max 50.

cursorstringOptional

Used for fetching next page. Cursor is returned in the response.

Response

Successful Response

resultslist of objects

has_moreboolean

Whether there are more results available

metaobject

next_cursorstring

Cursor for the next page of results

Errors

422

Messages Search Request Unprocessable Entity Error