Setup
From download to your first dataset.
Five steps, about fifteen minutes, and only one of them has any fiddliness in it.
A macOS or Windows (beta) computer
Nothing else to install: no runtime, no terminal, no toolchain. System requirements.
A rotating proxy account
DataImpulse, or any provider offering rotating residential proxies over HTTP. You buy it, you hold it, and the provider bills you for the traffic — it is never included in a licence.
A LeadCo licence
Three of them, running the same software and differing only in how long access lasts and how long updates are included. See pricing.
Download the right build
LeadCo is an ordinary desktop application. There is no Node.js to install, no Python, no terminal and no toolchain — you download one file and put it where your applications live.
Four builds exist and they are not interchangeable: two macOS disk images — Apple silicon and Intel — and two Windows binaries, an ordinary installer and a portable executable. Take the wrong Mac build and it simply will not open, without saying why.
On macOS
Open the disk image and drag LeadCo out of it into your Applications folder — do not run it from the mounted window. The first time you open it, right-click the app (or hold Control and click) and choose Open. macOS shows a warning with an Open button; press it. You do this once, and a normal double-click works from then on.
The warning appears because this build is not yet signed with a paid Apple developer certificate. Depending on your macOS version it reads “Apple could not verify LeadCo is free of malware”, “the developer cannot be verified”, or “is damaged and can’t be opened”. None of the three is true of the file you downloaded.
Your licence key
Your key is shown on the confirmation screen the moment your payment is confirmed, with a button to copy it. That screen is the delivery — copy the key and keep it somewhere you will find it again.
Then put it aside. It is your proof of licence rather than a lock — nothing in the application is held behind it, and the app never contacts us to check it.
Activation is not available in the current build
Version 5.0.0 ships with its licence service switched off. The Licence panel in Settings hides itself rather than showing a card that cannot do anything, so there is no screen in the application on which to enter a key — and nothing in the application is locked behind one. Install it and run.
When a version ships with activation, the Licence panel appears in Settings and you paste the key you already have. Version 5.0.0 has no in-app updater, so that version reaches you the way this one did: as a download from this site. Keys look like LCO5-XXXX-XXXX-XXXX-XXXX.
Until then the only thing to do with your key is keep it.
Connect your proxy
LeadCo reads the map through your own proxy account, and the Start button stays switched off until one is connected and tested. Any provider offering rotating residential proxies over HTTP works — DataImpulse is simply the one the in-app instructions are written for.
This is the only step with any fiddliness in it, and it is done once. Paste one line, press Test, press Save.
You buy the traffic directly from your provider and they bill you for it — none of it is included in any licence. Why a proxy at all, and why a rotating one, is answered on support.
LeadCo reaches the map through your own proxy. Your credentials stay on this computer.
host : port : username : password — one line, straight from your provider’s dashboard.
A drawing of the dialog, with example values. Pressing Test here contacts nothing — this is a webpage. In the application the same button tests your real credentials against the exact area you are about to search, and the credentials are stored on your own machine.
Choose an area and scrape it
Type a city into Where or click the map to drop the pin, set a radius, and press Start scrape. The default is every local business the map lists inside your circle, so you do not have to choose a niche before your first run.
Start small. A 500 m circle on a busy high street usually returns more of what you are looking for than a 5 km circle over a suburb — and area grows with the square of the radius, so the wide one is roughly a hundred times the ground to cover.
Connect a proxy to start
A drawing of the setup card. The radius slider carries the application’s real limits: 0.1 to 5.0 km, in steps of 0.1, kilometres only.
Advanced filters
Business status is not a control. Permanently and temporarily closed listings are never collected, and opening hours are never consulted.
A drawing of the filters drawer, and the whole shipped set: three segmented controls, each mutually exclusive, and two Advanced switches, both on for a new install.
Export the dataset
Two formats. A CSV of 36 columns, one row per business, which opens in Excel, Numbers or Google Sheets; or a PDF call sheet with a fixed three-column layout — business, phone, map link — for printing or sending to somebody who is going to ring them.
There is no export quota and no per-row charge, and exporting is never gated on your licence. Saved runs stay in your local history for seven days, so export anything you want to keep.
Everything this scrape collected. Nothing is dropped for lacking a phone.
Choose columns… adds scope — All businesses, Filtered or Selected — a column choice, and a comma or semicolon separator. It is CSV-only, because the PDF’s layout is fixed and those controls would silently do nothing to it.
A drawing of the export dialog. Two formats ship and no others: no XLSX, no JSON, no API, no CRM connector.
If it does not work first time.
Most setup problems are the proxy credentials, and most of those are a stray space picked up by a copy. These are the 10 that come up on a first run.
Which download do I need?
There are four build artefacts and they are not interchangeable.
- Apple silicon Mac — the
arm64disk image. Apple menu → About This Mac: if the Chip line says “Apple M-something”, this is yours. - Intel Mac — the disk image whose name ends
-x64. If About This Mac shows a Processor line naming Intel, take this one. - Windows — the setup
.exeis the ordinary route: it asks where to put LeadCo, makes the shortcuts, and needs no administrator rights. A portable.exealso exists for a locked-down machine or a USB stick — it installs nothing and runs from wherever you put it. Both are the same build, and the Windows build ships as a beta.
The wrong Mac build will not open, and macOS does not say why in so many words. If a download refuses to launch at all, check this first. The download page lists all four.
My computer says the app cannot be verified, or is damaged
This is expected, and it is not a problem with your download or your licence. The installers are not yet signed with a paid developer certificate, so both operating systems hold them on first launch. Every unsigned application gets the same treatment.
- macOS. Drag LeadCo out of the disk image first — do not run it from the mounted window. Then right-click the app (or hold Control and click) and choose Open. macOS shows a warning with an Open button; press it. You do this once; a normal double-click works from then on. Depending on your macOS version the wording is “Apple could not verify LeadCo is free of malware”, “cannot be opened because the developer cannot be verified” or “is damaged and can’t be opened”. None of the three is true of the file you downloaded.
- Windows. SmartScreen shows “Windows protected your PC”. The control that gets past it is More info, then Run anyway.
If you ever see either warning for software you did not deliberately download, do not do this. It exists for a reason.
If the app opens and closes again immediately, that is a crash rather than a block. Note anything on screen and send us your operating system and its version — the version is the part that identifies it.
Do I need a proxy, and why?
Yes. LeadCo reads the map through your own proxy account, and the Start button stays switched off until one is connected. No proxy ships with the application and none is included in any licence — you buy the traffic directly from a provider at their published rate, and they bill you for it.
The reason is capacity, not concealment. Sustained volume from a single connection gets rate-limited and the run stalls part-way through; a rotating pool spreads the requests across many addresses so a long run finishes.
Any provider offering rotating residential proxies over HTTP works. DataImpulse is simply the one the in-app instructions are written for. What the application needs from any of them is a host, a port, a username and a password.
The proxy test fails
Work through it in this order, testing after each change.
- Prefer the connection line over the four fields. Settings → Connect proxy takes a single pasted string in the form
host:port:username:passwordand splits it itself, which removes the two most common mistakes at once. - If you are filling the fields by hand: host and port belong in separate boxes. A host still carrying
:porton the end will not resolve. - The username and password are the proxy’s own credentials from your provider’s dashboard — not the email and password you sign in to DataImpulse with. Mixing those two up is the most common cause of all.
- A stray space picked up by a copy will fail exactly like a wrong password. So will an exhausted plan: check the account still has traffic on it.
- If your provider restricts access to allow-listed IP addresses, add the address of the computer running the application.
- Office networks, VPNs and security software block outbound proxy ports often enough to be worth ruling out. Try the same credentials on another network.
The test answers one question — can the application reach the internet through your proxy — and answers it in seconds, against the exact area you are about to search. Use it after every change rather than starting a run to find out.
Requests start failing part-way through a run
A run that starts fine and fails later is usually the address it is going out through rather than the application. A single residential IP serves a limited number of map requests in a session before the far end starts refusing them. There is no fixed figure — it varies with the address, the area and how hard you run — so treat it as a ceiling that exists rather than a number to plan against.
What helps, in the order worth trying:
- Use a rotating plan, so a long run is spread across the pool instead of loaded onto one connection.
- Split a large area into several smaller runs, and leave a gap between them.
- Reduce the radius. Area grows with the square of the radius, so doubling it is roughly four times the ground to cover.
If instead everything fails from the very first request, it is the connection and not the volume — go back to the proxy test.
The Start button is switched off
Two things arm it, and the application will not begin a run without both.
- A proxy. The chip in the top-right of the window reads Not configured until one is connected. Settings → Connect proxy.
- A place. Type a city into Where, or click the map to drop the pin yourself.
Nothing else is required. The default is All local businesses with the filters at their defaults, so you do not have to pick a niche before your first run.
A search returns no businesses
Separate the two possible failures first: reset the filters and run the area again. If businesses appear, the search was fine and your filters removed everything. If nothing appears even at the defaults, it is the search itself.
- Categories. You are selecting exact map categories. If the businesses in that street are filed under a neighbouring one, they are not in scope. Add the related categories, or switch to All local businesses.
- The pin. A small radius dropped one street off centre can miss the whole cluster you were aiming at.
- Filters. No site at all, Has a phone and 4.5+ together can legitimately leave an empty list in a small area. Remove them one at a time.
The export will not open, or is empty
Check the file first: open the folder the application wrote to and confirm it is there and is not zero bytes.
- Every field crammed into one column is a separator setting in the program opening it, not a broken export. European Excel expects a semicolon — choose it under Choose columns…, or re-import and set the delimiter explicitly.
- Accented characters showing as mojibake is a character-encoding setting in the same import dialog. The file itself is UTF-8 with a byte-order mark.
- If nothing was written at all, the destination is the usual cause: a folder the application cannot write to, or a file still open in a spreadsheet and therefore locked. Close it, or export somewhere else, and try again.
Where do I find my licence key?
Your key is shown on the confirmation screen immediately after payment, with a button to copy it. That screen is the delivery: copy the key and keep it somewhere you will find it again.
If you closed the page before copying it, write to us with your order reference and we will send it to you. The order reference is on the receipt from Creem, the seller of record on your statement.
The application never asks for my licence key
That is correct for the build you install today, and nothing is missing from your order. Version 5.0.0 ships with activation switched off: the licence panel in Settings is hidden rather than shown inert, because a panel about a system that cannot be used is worse than no panel. Nothing in the application is locked behind it, so you can install and run straight away.
When a version ships with activation, the Licence panel appears in Settings and you paste the key you already have. Version 5.0.0 has no in-app update channel, so that version arrives as a download from this site rather than as an update inside the application. Keys are in the form LCO5-XXXX-XXXX-XXXX-XXXX.
Until then: keep your key, and do not worry that you have not been asked for it.
That is the first-run subset. The full list lives on support, with a search over all of it and a direct route to a person.
Still stuck?
Write to thewebsitelabs@gmail.com. A person reads it, and setup problems are the ones we can usually answer in a sentence. We aim to reply within 3 business days.
The windows on this page are drawn representations of the application, built from its own controls and its own defaults. They are replaced with captures of the shipping build at release.