GET

Try GET /v1/convai/conversations/messages/text-search — ElevenLabs API

ElevenLabs playground

Text Search Conversation Messages

Credentials

ElevenLabs API key · sent as xi-api-key

Kept in this tab only. Requests go through apicheats.dev's same-origin proxy straight to api.elevenlabs.io; the proxy stores and logs nothing about them.

Query

text_query · required · string The search query text for full-text and fuzzy matching agent_id · optional · string Agent id (agent_…) or speech engine external id (seng_), resolved to the same underlying resource. visited_agent_ids · optional · string[] Filter conversations where any of these agents participated. Can not exceed 50 values. visited_agent_branch_ids · optional · string[] Filter conversations where any of these agent branches participated. Can not exceed 50 values. triggered_procedure_ids · optional · string[] Filter conversations where any of these procedures were triggered. Can not exceed 50 values. call_successful · optional · string The result of the success evaluation call_start_before_unix · optional · integer Unix timestamp (in seconds) to filter conversations up to this start date. call_start_after_unix · optional · integer Unix timestamp (in seconds) to filter conversations after to this start date. call_duration_min_secs · optional · integer Minimum call duration in seconds. call_duration_max_secs · optional · integer Maximum call duration in seconds. rating_max · optional · integer Maximum overall rating (1-5). rating_min · optional · integer Minimum overall rating (1-5). has_feedback_comment · optional · boolean Filter conversations with user feedback comments. user_id · optional · string Filter conversations by the user ID who initiated them. evaluation_params · optional · string[] Evaluation filters. Repeat param. Format: criteria_id:result where result is one of success|failure|unknown. Example: eval=value_framing:success data_collection_params · optional · string[] Data collection filters. Repeat param. Format: id:op:value where op is one of eq|neq|gt|gte|lt|lte|in. For in, pipe-delimit values. An empty value matches conversations where the field was not collected (id:eq:), and neq with an empty value matches where it was (id:neq:). eq is exact equality. gt|gte|lt|lte require a numeric value. dynamic_variable_params · optional · string[] Dynamic variable filters. Repeat param. Format: name:op:value where op is one of eq|neq|gt|gte|lt|lte|in. For in, pipe-delimit values. An empty value matches conversations where the variable was not set (name:eq:), and neq with an empty value matches where it was (name:neq:). eq is exact equality. gt|gte|lt|lte require a numeric value. Names containing ':' cannot be expressed. tool_names · optional · string[] Filter conversations by tool names used during the call. tool_names_successful · optional · string[] Filter conversations by tool names that had successful calls. tool_names_errored · optional · string[] Filter conversations by tool names that had errored calls. include_invalid_tool_calls · optional · boolean Also match tool calls that never ran. main_languages · optional · string[] Filter conversations by detected main language (language code). exclude_statuses · optional · string[] Exclude conversations with the given statuses. Useful for hiding in-progress / processing conversations from list views. termination_reasons · optional · string[] Filter conversations by their stored termination_reason (metadata.termination_reason). Repeat param to match any of several. page_size · optional · integer Number of results per page. Max 50. summary_mode · optional · string Whether to include transcript summaries in the response. conversation_initiation_source · optional · string query parameter conversation_initiation_source. text_only · optional · boolean query parameter text_only. conversation_product_type · optional · string Restrict results to a single conversation product surface. branch_id · optional · string Filter conversations by branch ID. version_id · optional · string Filter conversations by version ID. topic_ids · optional · string[] Filter conversations by topic IDs assigned during topic discovery. sort_by · optional · string Sort order for search results. 'search_score' sorts by search score, 'created_at' sorts by conversation start time. cursor · optional · string Used for fetching next page. Cursor is returned in the response.