# Bulk email finder: turn a list of LinkedIn URLs into work emails

> A bulk email finder turns a list of people into a list of email addresses in one job. Descovo's takes up to 2,000 LinkedIn profile URLs per request, returns results as each person finishes, and charges 2 credits per work email found. Anyone it cannot find is refunded when the job ends.

Source page: https://descovo.com/bulk-email-finder
Updated: November 20, 2026

## Queue a list with one request

Post a plain list of profile URLs to `https://api.descovo.com/v1/contacts/reveal/batch` and say which fields you want. The response comes back straight away with a `taskId`; the work runs in the background.

Queue the list:

```bash
curl -X POST https://api.descovo.com/v1/contacts/reveal/batch \
  -H "Authorization: Bearer $DESCOVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedinUrls":["https://www.linkedin.com/in/janedoe","https://www.linkedin.com/in/johnroe"],"enrichmentTypes":{"getWorkEmails":true,"getPersonalEmails":false,"getPhoneNumbers":false}}'
```

Collect results:

```bash
curl -X POST https://api.descovo.com/v1/contacts/reveal/batch/poll \
  -H "Authorization: Bearer $DESCOVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"taskId":"the-taskId-from-reveal-batch"}'
```

Python, end to end:

```python
import os, time, requests

API = "https://api.descovo.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['DESCOVO_API_KEY']}"}

urls = [line.strip() for line in open("linkedin_urls.txt") if line.strip()]

task = requests.post(
    f"{API}/contacts/reveal/batch",
    headers=HEADERS,
    json={
        "linkedinUrls": urls[:2000],
        "enrichmentTypes": {"getWorkEmails": True, "getPersonalEmails": False, "getPhoneNumbers": False},
    },
    timeout=60,
).json()["data"]

def poll(body):
    r = requests.post(f"{API}/contacts/reveal/batch/poll", headers=HEADERS, json=body, timeout=60)
    return r.json()["data"]

# Wait for the job to finish (results can also be read while it runs).
while not poll({"taskId": task["taskId"]})["done"]:
    time.sleep(5)

# Then read every page.
cursor = None
while True:
    body = {"taskId": task["taskId"]}
    if cursor:
        body["cursor"] = cursor
    page = poll(body)
    for row in page["pageResults"]:
        emails = [e["email"] for e in (row.get("outputs") or {}).get("emails", [])]
        print(row["inputs"]["linkedinUrl"]["value"], emails)
    cursor = page.get("nextCursor")
    if not cursor:
        break
```

## Results arrive as each person finishes

Post the `taskId` to `https://api.descovo.com/v1/contacts/reveal/batch/poll`. Each call returns the people finished so far, a progress count, and a `nextCursor` when there is another page. Keep calling until `done` is true. Polling is free.

- You do not have to wait for the whole list: the first results can be read while the rest is still running.
- Bulk results include only email addresses that passed a deliverability check.
- A person who has asked to be removed comes back marked as opted out, with no data and no charge.

## How a bulk job is billed

| What happens | What you pay |
|---|---|
| Work email found | 2 credits |
| Direct phone found | 3 credits |
| Both found for the same person | 5 credits |
| Nothing found for a person | Refunded when the job finishes |
| The same person listed twice | Counted once; the repeat is dropped |
| Collecting results | Free |

Credits are taken when you submit, once for each unique person and for the fields you asked for, so a job cannot overrun your balance halfway through. When the job finishes, everything that was not found is credited back. A 5,000-credit month covers 2,500 work emails found.

A reveal is charged only for the fields it finds: 2 credits for a work email, 3 for a direct phone, nothing when nothing is found.

## Lists longer than 2,000

Split the list and send one request per 2,000 URLs. Each request returns its own `taskId` and is billed and refunded on its own. An unknown field in the request body is rejected before anything is charged, so a typo cannot start a paid job by accident.

## Where the emails come from

Standard and Turbo reveals check several data sources in sequence for the same person, an approach usually called waterfall enrichment; Lite is a shallower, cheaper lookup. Bulk jobs use the Standard reveal.

## Prefer not to write code?

The dashboard does the same job without the API: save people from Search into a list, reveal the whole list at once, then export it as CSV. It spends the same credits at the same prices.

## What a bulk email finder will not do

- It will not find an email for everyone. People with no findable address are refunded.
- It will not send email. Descovo returns data; outreach stays in your own tools.
- It will not accept a list of names alone. Bulk reveal starts from LinkedIn profile URLs; to get those from names and companies, use [person match](https://descovo.com/docs/rest) first.

## Frequently asked questions

### How many emails can I find in one bulk request?

Up to 2,000 LinkedIn profile URLs per request. For longer lists, send several requests; each runs as its own job.

### How much does bulk email finding cost?

2 credits per work email found, 3 per direct phone, 5 when both are found. Plans start free with 500 credits, then $99 a month for 5,000 credits.

### Am I charged for people whose email is not found?

No. Credits are taken when you submit and anything not found is refunded when the job finishes.

### Can I get phone numbers in the same bulk job?

Yes. Set getPhoneNumbers to true in enrichmentTypes and each person's direct phone is returned when found.

### Is there a bulk email finder I can use without code?

Yes. In the Descovo dashboard you can save people from Search into a list, reveal the whole list at once and export it as CSV.

## Next

- [Get an API key](https://descovo.com/sign-up)
- [REST reference](https://descovo.com/docs/rest)
- [Contact enrichment API: one person at a time](https://descovo.com/contact-enrichment-api)
- [LinkedIn email finder API](https://descovo.com/linkedin-email-finder-api)
- [Pricing: plans and what each action costs](https://descovo.com/pricing)
