# Evaboot API

The Evaboot API is a JSON REST API that lets you extract prospects from LinkedIn
Sales Navigator and find or validate their professional email addresses.

## Quick start

Get your API key from the Evaboot dashboard under **Integrations → API**. If the
field is empty, click **Refresh** to generate one.

All requests take an `Authorization` header:

```bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.evaboot.com/v1/quota/
```

That call returns your credit balance and remaining daily quota, so it doubles as
a way to check your key works.

### Find an email

```bash
curl -X POST https://api.evaboot.com/v1/email-finder/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prospects": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "company_name": "Example Corp",
        "company_domain": "example.com"
      }
    ]
  }'
```

This returns a `job_id` immediately. Poll `GET /v1/email-finder/{job_id}/` for
results — it answers `202` while the job runs and `200` once it's done.

## What you can do

- **Extract from Sales Navigator** — turn a search or list URL into structured
  prospect data.
- **Find emails** — one prospect at a time, or thousands in a bulk job.
- **Validate emails** — check deliverability before you send.
- **Build searches** — describe an audience in plain language and get a Sales
  Navigator URL back.
- **Receive webhooks** — get a callback when a long-running job finishes.

## Costs

Extractions and email lookups draw on your Evaboot credit balance: 1 credit per
lead extracted with its verified email included (every lead extraction finds
emails), 1 per email found by the email finder, and 1 per email validated.
Search building is free. Check `GET /v1/quota/` before a large run.

## Support

- [Help Center](https://intercom.help/evaboot/)
- [YouTube](https://www.youtube.com/@JBEvaboot)