{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"All there is to know about Lusha's 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.","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":"all-there-is-to-know-about-lushas-api","__idx":0},"children":["All there is to know about Lusha's API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lusha's API gives you programmatic access to contact and company data for enrichment, prospecting, and sales intelligence. All requests are made over HTTPS and responses are returned in JSON format."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: API access requires an API key, which is available to Admins and Managers on Premium and Scale plans. For full endpoint documentation, visit ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.lusha.com"},"children":["docs.lusha.com"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":1},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Find your API key in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Hub"]}," (left sidebar). Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copy API key"]}," in the top right, or open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage API Keys"]}," tab to view and manage all your keys. Pass the key in the request header to authenticate. The key is shared at the account level and you can create several keys by pressing ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+Create new Key"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rate-limits","__idx":2},"children":["Rate limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Limits vary by plan:"]},{"$$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":"Plan"},"children":["Plan"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Per Minute"},"children":["Per Minute"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Per Hour"},"children":["Per Hour"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Per Day"},"children":["Per Day"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Free"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["40"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["100"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Starter"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["40"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["100"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pro"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["50"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["150"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1,500"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Premium"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["300"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1,800"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["18,000"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Scale"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["300"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5,000"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["50,000"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Free and Starter plans do not have an hourly limit — only per-minute and per-day caps apply."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rate limits are enforced per API key. Exceeding a limit will result in a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429 Too Many Requests"]}," response. To avoid a 429 error, implement retry logic with exponential backoff when hitting rate limits."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Legacay users will keep the same limits they always had; 300/minute, 600/hour, 6000/day."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-endpoints","__idx":3},"children":["Available endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["APIs"]}," tab in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Hub"]}," gives you a categorized view of every Lusha API: Prospecting, Enrichment, Signals, and Lookalikes. Each endpoint has a one-click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try"]}," button that opens the API playground with that action preloaded, so you can run live requests without any setup."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"person-api","__idx":4},"children":["Person API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieves contact data using identifiers like email, LinkedIn URL, name, company name, or domain. Returns location, email, phone, LinkedIn URL, and more. The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bulk Person API"]}," processes up to 100 contacts per request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"company-api","__idx":5},"children":["Company API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieves firmographic data for a company based on its domain or name — industry, employee count, location, revenue, and more. The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bulk Company API"]}," handles multiple domains or names in a single request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prospecting-api","__idx":6},"children":["Prospecting API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Queries Lusha's database using filters like job title, seniority, location, and industry to generate contact or company tables aligned with your ICP. The process has three stages: select filters, run the search, then enrich the results. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.lusha.com/apis/openapi/prospecting"},"children":["Prospecting API documentation"]}," for all available filters."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"lookalike-api","__idx":7},"children":["Lookalike API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Uses machine learning to find contacts and companies that mirror your best-performing customers. Contact Lookalikes match by role, seniority, and career trajectory; Company Lookalikes match by industry, headcount, revenue, and firmographic profile. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.lusha.com/apis/openapi/lookalikes"},"children":["Lookalike API documentation"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"signals-api","__idx":8},"children":["Signals API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enriches contacts and companies with timely sales intelligence like job moves, promotions, and company growth signals. Useful for triggering outreach at moments of change. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.lusha.com/apis/openapi/signals"},"children":["Signals API documentation"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"credit-usage-api","__idx":9},"children":["Credit Usage API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns current credit consumption by type. Rate limit: 5 requests per minute."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mcp","__idx":10},"children":["MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Hub"]}," includes a dedicated ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP"]}," tab. Grab your personal MCP URL there and follow the ready-made setup guides for ChatGPT, Claude, Cursor, and n8n to connect Lusha to any AI tool. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/mcp/lusha-model-context-protocol-mcp-server"},"children":["Lusha MCP Server"]}," article for full setup instructions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"credit-consumption","__idx":11},"children":["Credit consumption"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credits are charged based on two factors: the data points revealed and the number of API results returned."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data points (per reveal):"]}]},{"$$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":"Data point type"},"children":["Data point type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Credit cost"},"children":["Credit cost"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phone number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company info"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request type:"]}]},{"$$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":"Request type"},"children":["Request type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Results returned"},"children":["Results returned"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Credit cost"},"children":["Credit cost"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Single request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 contact/company"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per result"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bulk request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Up to 25 results"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1 credit per 1–25 results"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example: revealing an email and phone for one contact costs 7 credits total (5 for phone + 1 for email + 1 for the request)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Signals credits:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Growth Surge in Hiring: 1 credit per company"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Growth in Headcount: 1 credit per company"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Job Change: 1 credit per contact"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key rules:"]}," A minimum of 1 credit applies per request even if no data is returned. Maximum 100 contacts or companies per request. Each contact's data point is only charged once — re-querying the same contact won't incur additional charges for already-revealed data."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"managing-api-key-credit-limits","__idx":12},"children":["Managing API key credit limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can set monthly credit limits per API key to control consumption per workflow (e.g. Zapier, Make, or internal tools)."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Hub"]},", click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage API Keys"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["edit (pencil) icon"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set limit"]}," in the Credit usage column."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the Edit Key panel, toggle on the limit and enter the maximum credits allowed per month."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: Only Admins can set or edit credit limits. The sum of all individual API key limits cannot exceed your total account credit allowance. Limits reset automatically at the start of each billing cycle."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting-api-shows-credit-limit-reached-but-i-still-have-credits","__idx":13},"children":["Troubleshooting: API shows \"credit limit reached\" but I still have credits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your API calls are being rejected with a \"credit limit reached\" error but your Lusha dashboard shows credits remaining, the issue is almost always a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["per-API-key credit limit"]}," — not your account balance."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each API key can have its own monthly credit cap set independently of your total account balance. When a key's cap is reached, all requests using that key are blocked — even if the account still has plenty of credits available."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To check and fix the limit on your API key:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Hub → Manage API Keys"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find the key you're using and check the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credit usage"]}," column. If a limit is set and you've reached it, you'll see the cap amount here."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["edit (pencil) icon"]}," next to the key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the Edit Key panel, either increase the monthly credit limit or toggle the limit ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["off"]}," to remove it entirely."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]}," to save your changes."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note"]},": Only ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Admins"]}," can view and edit API key credit limits. If you don't have Admin access, ask your Lusha Admin to check the key's limit for you."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the key has no credit limit set and you're still seeing the error, contact ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.lusha.com/contact/"},"children":["Lusha Support"]}," with the API key name and the error message you received."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-handling","__idx":14},"children":["Error handling"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lusha's API uses standard HTTP response codes. See the full table in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.lusha.com"},"children":["API documentation"]}," or the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/lushas-api/lusha-api-error-codes-reference"},"children":["API Error Code Reference."]}]}]},"headings":[{"value":"All there is to know about Lusha's API","id":"all-there-is-to-know-about-lushas-api","depth":1},{"value":"Authentication","id":"authentication","depth":2},{"value":"Rate limits","id":"rate-limits","depth":2},{"value":"Available endpoints","id":"available-endpoints","depth":2},{"value":"Person API","id":"person-api","depth":2},{"value":"Company API","id":"company-api","depth":2},{"value":"Prospecting API","id":"prospecting-api","depth":2},{"value":"Lookalike API","id":"lookalike-api","depth":2},{"value":"Signals API","id":"signals-api","depth":2},{"value":"Credit Usage API","id":"credit-usage-api","depth":2},{"value":"MCP","id":"mcp","depth":2},{"value":"Credit consumption","id":"credit-consumption","depth":2},{"value":"Managing API key credit limits","id":"managing-api-key-credit-limits","depth":2},{"value":"Troubleshooting: API shows \"credit limit reached\" but I still have credits","id":"troubleshooting-api-shows-credit-limit-reached-but-i-still-have-credits","depth":2},{"value":"Error handling","id":"error-handling","depth":2}],"frontmatter":{"title":"All there is to know about Lusha's API","description":"An overview of Lusha's API endpoints, authentication, rate limits, credit consumption, and how to manage API key credit limits.","seo":{"title":"All there is to know about Lusha's API"}},"lastModified":"2026-06-25T08:28:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/lushas-api/all-there-is-to-know-about-lushas-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}