Smart search | ElevenLabs Documentation

from elevenlabs import ElevenLabs
from elevenlabs.environment import ElevenLabsEnvironment
client = ElevenLabs(
    environment=ElevenLabsEnvironment.PRODUCTION
)
client.conversational_ai.conversations.messages.search(
    text_query="Customer requesting refund for a delayed order",
    agent_id="21m00Tcm4TlvDq8ikWAM",
    page_size=10,
    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-keystringOptional

Query parameters

text_querystringRequired

The search query text for semantic similarity matching

agent_idstringOptional

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

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

next_cursorstring or null

Cursor for the next page of results

Headers

Query parameters

Response

Errors