Skip to main content
Instead of writing your first API request from scratch, you can build and validate your search in Tables, then copy the matching API request in your preferred language. This lets you confirm that your search returns the right results before you write a single line of code. This makes it easier to:
  • Build complex searches using filters and signals.
  • Verify that your search returns the expected results before writing code.
  • Skip manually constructing API request payloads.
  • Start from a working request in cURL, Python, or TypeScript.
In this article, you’ll learn how to build a search in Tables, generate the matching API request in cURL, Python, or TypeScript, and copy it into your workflow.

​
Before you begin

Make sure you have the following:
  • An active Lusha account with API access.
  • An API key - copy it from your API Dashboard.
API access is required to use the Get API Request feature. If you don’t see this option, check with your account Admin.

​
Plan availability

Available on all plans.

​
Step 1: Build your search in Workspace

1

Open Workspace

Open Workspace from the left navigation by pressing + New table.
2

Build your search

Use AI search or the Filter panel on the left to build your search. You can filter by location, industry, job title, signals, and more.
3

Review and adjust the results

Review the results in the table. Adjust your filters until the contacts or companies shown match what you’re looking for.
The table view lets you validate your search results visually - exactly what the API will return - before you run any code.

​
Step 2: Generate the API request

1

Click Get API Request

Once your search is ready, click Get API Request at the top of the page.
2

Choose your language

Choose your preferred language from the options:
  • cURL
  • Python
  • TypeScript
The generated request updates automatically to match your current search.
The Get API Request panel stays in sync with your filters. If you change your search, the request updates to reflect it - no need to regenerate manually.

​
Step 3: Copy and use the request

1

Copy the generated request

Click Copy to copy the generated request to your clipboard.
2

Paste it into your environment

Paste it into your preferred development environment, script, or API client.
3

Confirm or replace the API key

If your account has an API key, Copy automatically pastes the request with your real, unmasked key already in place - it’s ready to run as-is. If your account has no API key, the request keeps the LUSHA_API_KEY placeholder; replace it with your own key before running.
The on-screen preview always shows your key masked (prefix + bullets), even though Copy pastes the full key. If the key is still loading, Copy stays available and pastes the placeholder until the secret is ready.
Keep your API key private. Since Copy now includes your real key, avoid pasting the copied request into public repositories, shared docs, screenshots, or client-side code.

​
What happens next

Once you run the request, you’ll receive the same results you validated in Tables - formatted as a JSON response. Use this as the starting point for your integration instead of building the request body manually. You’re all set! Now you can build and validate API searches in Tables before writing a single line of code.
Related articles: