{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"Credits and Unified Recommendations List","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":"credits-and-unified-recommendations-list","__idx":0},"children":["Credits and Unified Recommendations List"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Unified Recommendations List gives you two AI-generated lead lists — one for Contacts and one for Companies — displayed in a spreadsheet view on your Lusha homepage. Contact and company identifiers are hidden by default, so you can explore, filter, and sort your recommendations before spending any credits. Credits are only charged when you choose to reveal an identifier. This article explains how the reveal process works and exactly when credits are consumed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"terminology","__idx":1},"children":["Terminology"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Two types of actions consume credits in the Unified Recommendations List. Understanding the difference will help you know exactly what you're paying for before you confirm any action."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reveal"]}," — Unblurring a contact's or company's identifying fields: name, LinkedIn URL, company website, logo, and description. It's triggered when you click the reveal icon directly, or automatically when you try to show connect details or save a blurred row to a list. A reveal costs ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1 credit per row"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Show"]}," — Surfacing a contact's connect details: work email and/or phone number. A show costs ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1 credit per email"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5 credits per phone"]},". If the contact row is still blurred when you request a show, a reveal is triggered first — and both actions are charged together."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-are-the-unified-recommendations","__idx":2},"children":["What Are the Unified Recommendations?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each day, Lusha generates a fresh list of recommended Contacts and Companies tailored to your Ideal Customer Profile (ICP). The lists are displayed in a spreadsheet view and support up to 10,000 recommendations per entity type."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recommendations are scored and ranked so the best-fit leads appear first. Each row shows:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lead Score"]}," — how well the contact or company matches your Target Profile and current signals"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Signals"]}," — active buying indicators such as job changes, hiring surges, intent, or website traffic growth"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Target Profile"]}," — the ICP that triggered the recommendation (your defined profile, or Lusha's calculated one)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standard profile fields"]}," — job title, industry, headcount, HQ location, and more"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-warning"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Warning:"]}," Identifiers — such as contact name, LinkedIn URL, company name, and company website — are blurred until you reveal them. You are never charged just for viewing the list."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-will-be-blurred-by-default","__idx":3},"children":["What Will be Blurred by Default?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following fields are hidden in the recommendations list until you perform a reveal action. The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["top 3 contacts"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["top 3 companies"]}," in the list are always visible by default — no reveal required."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"contact-recommendations","__idx":4},"children":["Contact Recommendations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact Name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact LinkedIn URL"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"company-recommendations","__idx":5},"children":["Company Recommendations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Company Name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Company Logo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Company Website"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Company LinkedIn URL"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Company Description"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All other fields — Lead Score, Signals, Target Profile, job title, industry, headcount, and location — are always visible at no cost."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-credits-are-consumed","__idx":6},"children":["How Credits Are Consumed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credits in the Unified Recommendations List follow a reveal model — you're only charged when you choose to act on a lead."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1 credit is charged"]}," per revealed row (contact or company)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Showing a contact's details"]}," costs the standard rate: 1 credit per email, 5 credits per phone"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Saving a contact to a list ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["automatically triggers"]}," a details show action"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A toast notification shows the exact credits charged after any bulk action"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If your account has no credits remaining, you'll see an out-of-credits notification when attempting to reveal"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bulk-reveal","__idx":7},"children":["Bulk Reveal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use bulk reveal to unblur multiple rows at once. Available options:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Selected rows on the current page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All rows on the current page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Top X results (specific limits subject to final product configuration)"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 Note:"]}," A tooltip on the bulk reveal button shows the total credits that will be consumed before you confirm."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-warning"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Warning:"]}," Revealed contacts and companies are not automatically added to your All Contacts or All Companies list. **You must save them manually to keep them after the next daily refresh.**"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"showing-contact-details","__idx":8},"children":["Showing Contact Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Contact recommendations, you can show their details (work email, phone, or both) directly from the table."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the contact row is still blurred when you request connect details:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A reveal is triggered automatically"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Credits are charged for both the reveal action and the connect details show"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The UI displays the combined credit cost before you confirm"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the contact row is already revealed, only the connect details credits apply."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 Note:"]}," After a bulk connect details action, a toast message confirms that contacts were saved to All Contacts and shows the total credits consumed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"saving-to-a-table","__idx":9},"children":["Saving to a Table"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can save recommendations to a Contact table or Company table directly from the table. If you attempt to save a row whose identifiers are still blurred:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A reveal is triggered automatically"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A confirmation prompt appears with the credit cost"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must explicitly approve the action before credits are charged"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["💡 Note:"]}," Blurred rows cannot be saved without first revealing the identifier. The confirmation step ensures you're always aware of credit usage before it happens."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-reveals-work-across-your-team","__idx":10},"children":["How Reveals Work Across Your Team"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reveals in the Unified Recommendations List are shared ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["at the account level"]},", not per user."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When any user in your account reveals a contact/company, it becomes visible to all users in the account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A revealed contact/company stays unblurred for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3 months"]}," across the entire account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the next daily refresh, previously shown contact/company are removed from the recommendations list by default — they move into your regular contact or company records instead"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["There is one edge case to be aware of:"]}," if another user in your account revealed a contact's details in the past, the recommendation will still appear blurred with no indication that connect details were already revealed. When you perform a showing action on that row, both the details and the previously revealed connect details appear immediately — but you are only charged for the showing action."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"accessing-recommendations-via-mcp","__idx":11},"children":["Accessing Recommendations via MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your scored contact and company recommendations are also available as MCP tools, so agents in Slack, your CRM, n8n, or any other MCP-compatible client can fetch them directly — no Lusha login needed. Results are drawn from your own Target Profiles (plus any shared account-level profiles), refresh daily, and recalculate within minutes of an ICP change."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.lusha.com/mcp-docs"},"children":["MCP Server documentation"]}," for the full list of recommendations tools and setup instructions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now you're ready to explore recommendations and reveal leads with full confidence."]}]},"headings":[{"value":"Credits and Unified Recommendations List","id":"credits-and-unified-recommendations-list","depth":1},{"value":"Terminology","id":"terminology","depth":2},{"value":"What Are the Unified Recommendations?","id":"what-are-the-unified-recommendations","depth":2},{"value":"What Will be Blurred by Default?","id":"what-will-be-blurred-by-default","depth":2},{"value":"Contact Recommendations","id":"contact-recommendations","depth":3},{"value":"Company Recommendations","id":"company-recommendations","depth":3},{"value":"How Credits Are Consumed","id":"how-credits-are-consumed","depth":2},{"value":"Bulk Reveal","id":"bulk-reveal","depth":2},{"value":"Showing Contact Details","id":"showing-contact-details","depth":2},{"value":"Saving to a Table","id":"saving-to-a-table","depth":2},{"value":"How Reveals Work Across Your Team","id":"how-reveals-work-across-your-team","depth":2},{"value":"Accessing Recommendations via MCP","id":"accessing-recommendations-via-mcp","depth":2}],"frontmatter":{"title":"Credits and Unified Recommendations List","description":"How the Unified Recommendations List works, what contact and company identifiers are blurred by default, and exactly when credits are charged.","seo":{"title":"Credits and Unified Recommendations List"}},"lastModified":"2026-07-13T12:11:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/ai-recommendations/credits-and-unified-recommendations-table","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}