Smart search | ElevenLabs Documentation

curl -G https://api.elevenlabs.io/v1/convai/conversations/messages/smart-search \
     -H "xi-api-key: sk_live_4f3b2a1c9d8e7f6a5b4c3d2e1f0a9b8c" \
     -H "Content-Type: application/json" \
     --data-urlencode "text_query=Customer requesting refund for a delayed order" \
     -d agent_id=21m00Tcm4TlvDq8ikWAM \
     -d page_size=10 \
     -d cursor=eyJwYWdlIjoxLCJpZCI6IjEyMzQ1NiJ9

{
  "results": [
    {
      "conversation_id": "conv_9876543210",
      "agent_id": "21m00Tcm4TlvDq8ikWAM",
      "transcript_index": 5,
      "chunk_text": "I understand your order was delayed and you would like a refund. Let me check the details and assist you with the refund process.",
      "score": 0.92,
      "conversation_start_time_unix_secs": 1685000000,
      "agent_name": "Support Agent Jane"
    }
  ],
  "has_more": false,
  "meta": {
    "total": 1,
    "page": 1,
    "page_size": 1
  },
  "next_cursor": "eyJwYWdlIjoyLCJpZCI6Ijk4NzY1NDMyMSJ9"
}

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

Headers

xi-api-keystringRequired

Query parameters

text_querystringRequired

The search query text for semantic similarity matching

agent_idstring or nullOptional

The id of the agent you're taking the action on.

page_sizeintegerOptional1-50Defaults to 20

Number of results per page. Max 50.

cursorstring or nullOptional

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 or null

Cursor for the next page of results

Errors

422

Unprocessable Entity Error