{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"Conversation Intelligence API","description":"Access documentation, use cases, and technical guides for Lusha. Learn how to query our comprehensive dataset of business profiles and company information using our three main endpoints.","siteUrl":"https://docs.lusha.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"conversation-intelligence-api","__idx":0},"children":["Conversation Intelligence API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search your account's Lusha Conversations call history and pull call data directly into your own code or an AI assistant, instead of opening the Conversations dashboard."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lusha Conversations already records, transcribes, and analyzes your sales calls — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/getting-started-with-conversations/lusha-conversations-overview"},"children":["Lusha Conversations Overview"]}," for what the product does. This article covers the two ways to reach that same data programmatically: a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conversations Search"]}," endpoint and a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transcript"]}," endpoint, both available through the API and through Lusha's MCP Server."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-concepts","__idx":1},"children":["Key concepts"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conversations Search"]}," — finds calls matching filters (date range, company, participant, keyword) and returns everything about each one ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["except"]}," the transcript: summary, coaching scores, chapters, topics, and participants."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transcript"]}," — a separate request that returns the speaker-by-speaker transcript for one call."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Coaching"]}," — four fixed sections per call: opening, qualification, demo, and closing, each with what happened, what to keep, and what to improve, plus an overall score."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Completed conversations only"]}," — a call only appears once its recording and analysis have finished processing. An empty summary or coaching section on a recent call means analysis isn't ready yet, not that nothing was found."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-access-it","__idx":2},"children":["How to access it"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/account/conversations/search"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v3/account/conversations/{conversationId}/transcript"]},". See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.lusha.com/apis/openapi/conversations"},"children":["Conversations API documentation"]}," for full parameters and response schemas."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP"]}," — the same two capabilities are exposed as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversations_search"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversations_transcript_get"]}," tools on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/mcp/lusha-model-context-protocol-mcp-server"},"children":["Lusha MCP Server"]},". Ask your connected AI client to find a call or pull a transcript, and it calls these tools for you."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: There's no separate endpoint or tool to fetch a single conversation by itself — search with just that conversation's ID to retrieve it."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-get-back","__idx":3},"children":["What you get back"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each result from Search includes the call's title, date, duration, meeting type, company, participants, topics, coaching scores, summary (highlights, action items, next steps, risks and objections, competitor mentions), and chapters. The transcript is never included in Search results — fetch it separately with the Transcript request."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: Rolling up action items, competitor mentions, or risks across multiple calls or a whole account isn't built in yet — pull the calls you want with Search and aggregate them on your side."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"credits","__idx":4},"children":["Credits"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: This is currently available via the API and MCP only. Platform support may follow in a future update."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cost"},"children":["Cost"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conversations Search"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per block of up to 25 results returned (1–25 results = 1 credit, 26–50 = 2, and so on)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search returning zero results"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Free"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transcript"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per request"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," Every transcript request charges a credit — including re-fetching a transcript you already pulled, and each page of a multi-page transcript. A long call's transcript may span several pages, so pulling it repeatedly adds up."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"who-is-it-for","__idx":5},"children":["Who is it for"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Available on the API and MCP, for any account with API access enabled. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/lushas-api/all-there-is-to-know-about-lushas-api"},"children":["All There Is to Know About Lusha's API"]}," for how API access and credit limits work today."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now you can bring your call data wherever you already build."]}]},"headings":[{"value":"Conversation Intelligence API","id":"conversation-intelligence-api","depth":1},{"value":"Key concepts","id":"key-concepts","depth":2},{"value":"How to access it","id":"how-to-access-it","depth":2},{"value":"What you get back","id":"what-you-get-back","depth":2},{"value":"Credits","id":"credits","depth":2},{"value":"Who is it for","id":"who-is-it-for","depth":2}],"frontmatter":{"title":"Conversation Intelligence API","description":"Search your recorded sales calls and retrieve their transcripts through the API or an MCP-connected AI client.","seo":{"title":"Conversation Intelligence API"}},"lastModified":"2026-08-20T08:10:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/lushas-api/conversation-intelligence-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}