> ## Documentation Index > Fetch the complete documentation index at: https://docs.loice.ai/llms.txt > Use this file to discover all available pages before exploring further. # Leads Search > Find people by job title, company, location, industry, headcount, seniority and function, then reveal emails, save them to lists or export them. **Leads Search** (sidebar → **Leads search**) finds people who match your criteria when you do not know them in advance — for example *heads of sales at 51–200 person SaaS companies in Germany*. From the results you reveal verified work emails, add people to [lists](https://docs.loice.ai/lead-lists.md) or export them as CSV. ## Run a search **1. Set filters** Fill in one or more filters in the left panel. **Hide filters** / **Show filters** toggles the panel; its header counts how many filters are set, and **Clear all** resets them. **2. Click Search leads** The search runs in the background on our servers. You can leave the page or close the tab: nothing is lost, and the results are there when you come back. Progress reads *"N of up to 25 leads delivered…"* with the elapsed time. **3. Work with the results** Reveal emails row by row, select rows and **Add to list** or **Export**, or open another results page. **Stop search** cancels a search in progress. You pay only for the leads already delivered. ## Filters At least one filter is required. Each filter takes **up to 20 values** of up to 200 characters. A value outside a fixed list (for example a seniority that does not exist) is refused, never silently dropped. | Filter | Input | Notes | | - | - | - | | **People** | Names, press Enter | Look for specific people by name. | | **Job Title** | Free text tags, e.g. `Head of Sales` | Matches the person's current title. | | **Company** | Free text tags, e.g. `Loom` | The current employer. | | **Location** | Free text tags, e.g. `United States` | Country, region or city. | | **Keywords** | Free text tags | Anywhere in the profile. | | **Employee Headcount** | Checklist | Size of the current employer. | | **Industry** | Searchable hierarchy | Up to 10 industries per search. | | **Years of Experience** | Checklist | Total professional experience. | | **Seniority Level** | Checklist | | | **Function** | Checklist | The person's department. | | **Buying Intent** | — | Not available yet. | > [!NOTE] > > **Job Title**, **Location** and **Keywords** match English text. A value in another script > (Cyrillic, Chinese…) is accepted, with a warning: most profiles are listed in English, so it may > match few or no people. Write `Germany`, not `Deutschland`. > [accordion] Employee Headcount values > > Self-employed, 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. > [accordion] Seniority Level values > > In Training, Entry Level, Senior, Strategic, Entry Level Manager, Experienced Manager, > Director, Vice President, CXO, Owner / Partner. > [accordion] Function values > > Accounting, Administrative, Arts and Design, Business Development, Community & Social > Services, Consulting, Customer Success and Support, Education, Engineering, Entrepreneurship, > Finance, Healthcare Services, Human Resources, Information Technology, Legal, Marketing, Media > and Communication, Military and Protective Services, Operations, Product Management, Program > and Project Management, Purchasing, Quality Assurance, Real Estate, Research, Sales. > [accordion] Years of Experience values > > Less than 1 year, 1-2 years, 3-5 years, 6-10 years, 11-15 years, 16-20 years, 20+ years. > [accordion] Industry groups > > The LinkedIn industry taxonomy (434 industries). Its top-level groups are: Accommodation > Services; Administrative and Support Services; Construction; Consumer Services; Education; > Entertainment Providers; Farming, Ranching, Forestry; Financial Services; Government > Administration; Holding Companies; Hospitals and Health Care; Manufacturing; Oil, Gas, and > Mining; Professional Services; Real Estate and Equipment Rental Services; Retail; Technology, > Information and Media; Transportation, Logistics, Supply Chain and Storage; Utilities; > Wholesale. Search inside the filter to pick a specific industry. ## Results Results arrive in **pages of 25**. A search can reach up to 100 pages (2,500 people — the source's ceiling for one set of filters; narrow the filters to reach different people). * Opening a page you already loaded is free. * Opening a page that was not loaded yet fetches that page only, and bills the people it delivers. * A person already delivered by this search is never delivered or billed again on a later page. | Column | What it shows | | - | - | | **Name** | The person, with a link to their LinkedIn profile. Click the row for the full profile: department, seniority, years of experience, history. | | **Title** | Their current title. | | **Company** | Their current employer, with its logo. | | **Domain** | The company's website domain. | | **Email** | A **Reveal** button, or the revealed email. | | **Industry** | The company's industry. | | **Company links** | Icons for the company's contact channels and social profiles. | Company details (domain, industry, logo) fill in a moment after the rows appear — the cells read *Looking up domain* / *Looking up industry* meanwhile. ## Reveal an email Click **Reveal** in a row's Email cell. Loice runs the [Email Finder](https://docs.loice.ai/email-finder.md) for that person at their company domain and shows a verified work email, or **No email found**. * A reveal that ran is billed, found or not. * An email your workspace already revealed shows **Revealed earlier** and is free. * A row that cannot be searched shows **Can't be searched** with the reason — *No company domain*, *Not a mail domain* or *No full name* — and costs nothing. ## Find emails with the search Above **Search leads**, two switches find emails **together with the search**: * **Find email** — each person's verified work email; * **Find personal email** — each person's verified personal email, from their LinkedIn profile. Each switch shows its price per person, and the line under them the most they can add to a page (*Emails add up to N points*). With a switch on, every person the search delivers — on this page and on every page you open next — gets the email by itself a moment after the row appears (the cell reads *Finding…*). A strip says *Finding emails — N people to go*; **Stop finding emails** stops the rest, and you pay only for the emails already found. Each email is exactly a **Reveal** of that row, charged the same way: a found email or a confirmed miss is charged, a lookup that cannot run (no company domain, no LinkedIn profile, a provider that is not answering) is free and leaves the row's **Reveal** button. Revealing the same row later never charges again. A search the workspace cannot afford **including** the emails is refused before it runs; if points run out while emails are being found, finding stops and the rest can still be revealed row by row. ## Add to a list or export Select rows and click **Add to list** or **Export**. Choose **Rows to export**: * **All results** — type how many (up to 100,000 per job); * **Current page**; * **Selected (N)**. For a list, pick an existing one or **+ Create new list**. For an export, choose what to include: * **Lead data** — name, title, location and the company: name, about, LinkedIn, logo, domain, industry, location, headcount, email and social profiles; * **Email addresses** — a verified email for each row, revealed now where needed. The footer shows the cost and what it leaves in your balance. People and emails your workspace already holds are free. Large jobs run in the background (*"You can keep working"*) with a progress bar and a **Stop** button, and end with **Open list** or **Download CSV**. A background job can stop early — *not enough points*, *another search kept the workspace busy*, *the list is full* or an error. What it already bought is kept. ## Saved searches and history **Save search** stores the current filters under a name. **Search history** shows your recent and saved searches; click one to load its filters. A saved filter that is no longer supported is skipped and named in a notice. ## One search at a time A workspace runs **one search at a time**: a Leads Search, an [Employee Finder](https://docs.loice.ai/employee-finder.md) search or batch, an [ICP Builder](https://docs.loice.ai/icp-builder.md) generation, or a large Add to list / Export job. Starting another while one runs answers *"A search is already running — wait for it to finish or stop it first."* ## Billing * Billed **per lead delivered**. The worst case for the page is held when the search starts and settled when it ends; a search that delivers nobody is free. * A search the workspace cannot afford is refused before it runs: *"Not enough points for this search — nothing was charged."* * If points run out mid-search, the search stops; the leads already delivered are kept and only they are charged. * A source failure is never charged. * A repeated identical search may be answered from our cache (pages that found people are kept for about 30 days). A cached page is billed the same as a fresh one. * People on your [do-not-contact list](https://docs.loice.ai/do-not-contact.md) are never delivered, counted or charged. See [Plans and points](https://docs.loice.ai/plans-and-points.md) for where the current prices are shown. ## Messages you may see | Message | Meaning | | - | - | | *Add at least one filter to search.* | Every filter is empty. | | *Up to 20 values per filter.* | Remove some values. | | *Those filters can't be searched — check them and try again.* | The source refused the combination. Nothing was charged. | | *Our data provider is busy right now — this search was not run…* | Try again in a minute. Nothing was charged. | | *Lead search failed. Please try again.* | An unexpected failure. Nothing was charged. | | *Removed at the person's request* | The person exercised their right to erasure. | > [!TIP] > > The same search is available programmatically: see [Lead-search runs](https://docs.loice.ai/lead-search-runs.md) for > the API, and `search_leads` on the [MCP server](https://docs.loice.ai/mcp-server.md#tools). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.