Install Cuvy, run a search, read the result
Install the extension, sign in, and open a LinkedIn or Sales Navigator search. The side panel counts the people it can read on the page and shows what the run would cost before it starts. Start it and the work moves to the server, so closing the tab changes nothing. Results are split by state, and each state exports on its own.
- Runs in
- Chrome, Edge, Brave, Arc
- Reads
- The results page you opened
- Sends from your account
- Nothing
- Export states
- Verified, risky, provided, not found
No card. Nothing is sent from your LinkedIn account, ever.
Three steps, once
You need a Chromium browser and an account. There is nothing to configure afterwards.
- Listing pending
Get the extension
The Chrome Web Store listing is not live yet, so the install link comes with your account rather than from a store page. Create an account and it is on the first screen.
- Right-hand panel
Pin it, then sign in
Pin Cuvy from the extensions menu so the icon stays visible. Click it and sign in with the account you just made. The panel opens down the right-hand side of the window.
- Once, after install
Reload any LinkedIn tab you already had open
The extension attaches to a page as that page loads, and only on www.linkedin.com. A tab opened before you installed will not have it until you reload.
What happens between the search and the file
- The page you opened
Run the search in LinkedIn or Sales Navigator
Any people search, or a saved lead list. The panel reads the results page you are on and shows the query it found and the source it came from.
- Cost shown first
Check the count before you spend
The panel counts the people it can read on this page and shows what the run would cost. Nothing has been spent at this point. Rows LinkedIn will not name are counted separately, because a person with no name cannot be looked up.
- Survives the tab
Start it and leave
The job moves to the server. Closing the panel, the tab or the browser does not cancel it, and the header reads RUNNING until it is finished.
- A file per state
Export by state
When it finishes, the results are split by what was found. Each state exports on its own, so the file that goes to your sequencer is not the file you still have to read through.
What the panel is telling you
The word in the top-left of the panel is the run's state. The label on a row is a claim about the address on it. They are two different things and it is worth knowing which one you are looking at.
| Panel says | What it means | What to do |
|---|---|---|
| Idle | No search on this tab for it to read. | Open a people search or a saved lead list. |
| Search detected | It can read this results page. The count and the cost are shown and nothing has been spent. | Check the number, then start it. |
| Running | The job is on the server and the counters are moving. | Nothing. Close the tab if you want to. |
| Paused | It reached your balance and stopped. Everything found is kept and nothing was charged past it. | Top up, then run the rest into the same list. People already found are not looked up again. |
| Done | Finished, with the rows split by what was found. | Export the states you want, separately. |
The label on a row
Four of them, and they mean the same thing in the panel, in the app and in the email_status column of an export.Verified is two independent sources agreeing, or a check that reached the mailbox. Risky is one sighting, shown with that sighting. Provided is an address you supplied that a lookup has not improved on. Not found is nothing we would stand behind, and the row carries no address at all. The email finder page has the long version of each, with what to do about it.
On the invoice the rule is simpler than the labels. A row that hands you an address costs one credit, whether the label says verified or risky. A miss, a role mailbox and an address you supplied yourself cost nothing.How we bill sets out the rest.
Getting the list out
- CSV
- HubSpot
- Salesforce
- Pipedrive
- Zoho CRM
- Attio
- Creatio
- Outreach
- Salesloft
- Gong Engage
- Zapier
- Clay
- Slack
- Webhook
- API
Those are the places a finished list can go today. Salesforce, Zoho CRM and Outreach are built but need a developer app registered before a workspace can connect one; Google Sheets is not built. Exports are made per state: pick one — or several — and you get a file containing only those rows, rather than one file with a column you have to filter. Most people take the verified file to their sequencer and keep the risky one for a human to look at.
Every CSV carries the same columns in the same order, whichever state you exported: full_name, first_name,last_name, title, company,company_domain, location,email, email_status,confidence, mobile,mobile_status, enriched_at. A field containing a comma is quoted, so a company called Acme, Inc. does not shift every column after it.
Every export is listed in the web app with what it held and when it was made, and on Pro and above the history keeps the file itself — so losing a download is not a reason to run anything a second time.
The four things that go wrong
In the order support gets asked about them.
The extension is not there
- It only attaches on
www.linkedin.com. A LinkedIn URL without thewww, or any other site, shows nothing at all — that is deliberate, not a fault. - It attaches as a page loads. Reload any tab that was open before you installed it.
- Pin it. Unpinned, the icon sits inside the extensions menu and the panel looks missing when it is only hidden.
- If the panel will not open at all, open it from the toolbar icon rather than from the page. A browser with no side panel cannot show it.
The run stopped
Two different things wear the same word. Paused means it reached your credit balance and stopped on purpose: everything found so far is kept, nothing was charged past the balance, and topping up lets you run the remainder into the same list. Anything else is a failure rather than a finish — start it again on the same list, and the people already found are not charged a second time.
Rows are missing
- LinkedIn shows no name for people outside your network, and a row with no name cannot be looked up. The panel counts those separately rather than quietly dropping them.
- Only the page you are on is read. Page through the results, or save the search and re-run it, rather than expecting one run to walk the whole result set.
- On a re-run, people you have already paid for are skipped instead of looked up again. The job card shows how many were skipped for that reason.
- Somebody missed recently is left alone for a cooling-off period — thirty days unless you change it — before another attempt is made. Retries cost nothing, but they are not instant.
The export is empty
- An export covers the states you ticked. If the run found nothing verified, the verified file is a header row and no rows. Export the risky and not-found states to see who is in them.
- Check which list you exported. A file made from the whole workspace and a file made from one list are different files with similar names.
- If nothing downloads at all, the browser blocked it or the session expired. Sign in again and re-export from the web app.
Still stuck: support takes the list name, the rough time the run started and whatever the panel said. Those three things are what let somebody find your run instead of asking you for them.
Asked while using it
How long does the whole install take?
About 40 seconds, and there is nothing to configure afterwards. Create an account, install the extension from the link on the first screen, sign in, and the side panel is there on the next LinkedIn search you open. The free plan gives you ${STATS.freeMonthly} addresses a month to try it on, with no card.
Do I have to keep the side panel open while a run works?
No. The panel starts the job and then only reports on it. The work happens on the server, so you can close the panel, close the tab, or shut the browser, and the run carries on. Reopening the panel picks the progress back up where it is.
Where do lists and exports live after a run?
In the web app. Every run writes to a list, and the list keeps its rows and their states for as long as the workspace does. The exports you have made are listed there too, with what each one contained and when. The panel is for starting work and watching it; the app is where the work is kept.
What is the confidence column for?
It records how an address was arrived at, as a number out of a hundred. It is not a probability and should not be read as one. Two independent sightings plus a check that reached the mailbox sit near the top; a house style at a domain that accepts anything sits well below it. Use it to rank several candidates for one person, not to decide whether to send.
None of this fixed it. How do I get a person?
Email support@cuvy.io with the list name and roughly when the run started, and paste anything the panel said. Those two details are what let us find the run in the logs, which is usually the difference between an answer today and three messages of questions.