Find your first email in 5 minutes
No experience needed. You'll send one request to Icypeas with a name and a company, and get the person's professional email address back.
- An Icypeas account (create one for free).
- A computer: Mac, Windows or Linux. Nothing to install.
Skip this page and follow the Google Sheets, Make, Zapier or n8n guide instead.
Step 1: copy your API key
Your API key is like a password that lets tools use your Icypeas account.
- Open the API page of the Icypeas app.
- Switch on Activate API Access.
- Copy the value of the API Key field.
Keep it somewhere safe: anyone with this key can spend your credits. More details on API keys.
Step 2: start the search
Fill in the person you're looking for. The command below updates as you type, and you can paste your API key so you don't have to edit the command afterwards.
- Mac / Linux (Terminal)
- Windows (PowerShell)
- JavaScript
- Python
curl -X POST "https://app.icypeas.com/api/email-search" \
-H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-d '{
"firstname": "Pierre",
"lastname": "Landoin",
"domainOrCompany": "icypeas.com"
}'
$headers = @{
"Authorization" = "YOUR_API_KEY"
"Content-Type" = "application/json"
}
$body = @'
{
"firstname": "Pierre",
"lastname": "Landoin",
"domainOrCompany": "icypeas.com"
}
'@
$response = Invoke-RestMethod -Method POST -Uri "https://app.icypeas.com/api/email-search" -Headers $headers -Body $body
$response | ConvertTo-Json -Depth 10
const response = await fetch("https://app.icypeas.com/api/email-search", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "YOUR_API_KEY",
},
body: JSON.stringify({
"firstname": "Pierre",
"lastname": "Landoin",
"domainOrCompany": "icypeas.com"
}),
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
"https://app.icypeas.com/api/email-search",
headers={"Authorization": "YOUR_API_KEY"},
json={
"firstname": "Pierre",
"lastname": "Landoin",
"domainOrCompany": "icypeas.com",
},
)
print(response.json())
How to run it:
- On Mac: open the Terminal app (press ⌘ + Space, type Terminal, press Enter). Paste the command, press Enter.
- On Windows: open PowerShell (press the Windows key, type PowerShell, press Enter). Pick the Windows (PowerShell) tab above, paste the code, press Enter.
You get an answer like this right away:
{
"success": true,
"item": {
"status": "NONE",
"_id": "p_gfS5EB4liCGm90KDFC"
}
}
"success": true means Icypeas has accepted your search. Copy the value of _id: it's the ticket number of your search.
"Unauthorized access.": the API key is wrong, or API access is not activated. Go back to step 1."success": falsewithvalidationErrors: a field is missing or empty. Check the name and company.
All errors and their fixes are listed in Errors and troubleshooting.
Step 3: get the email
Wait 5 to 10 seconds, then ask for the result with the _id you just copied:
- Mac / Linux (Terminal)
- Windows (PowerShell)
- JavaScript
- Python
curl -X POST "https://app.icypeas.com/api/bulk-single-searchs/read" \
-H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-d '{
"id": "PASTE_THE_ID_HERE"
}'
$headers = @{
"Authorization" = "YOUR_API_KEY"
"Content-Type" = "application/json"
}
$body = @'
{
"id": "PASTE_THE_ID_HERE"
}
'@
$response = Invoke-RestMethod -Method POST -Uri "https://app.icypeas.com/api/bulk-single-searchs/read" -Headers $headers -Body $body
$response | ConvertTo-Json -Depth 10
const response = await fetch("https://app.icypeas.com/api/bulk-single-searchs/read", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "YOUR_API_KEY",
},
body: JSON.stringify({
"id": "PASTE_THE_ID_HERE"
}),
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
"https://app.icypeas.com/api/bulk-single-searchs/read",
headers={"Authorization": "YOUR_API_KEY"},
json={
"id": "PASTE_THE_ID_HERE",
},
)
print(response.json())
The answer looks like this (shortened):
{
"success": true,
"items": [
{
"status": "DEBITED",
"results": {
"firstname": "Pierre",
"lastname": "Landoin",
"fullname": "Pierre Landoin",
"emails": [
{
"email": "pierre.landoin@icypeas.com",
"certainty": "ultra_sure",
"mxProvider": "google",
"mxRecords": ["google.com"]
}
]
}
}
],
"total": 1
}
🎉 That's it. The email is in emails, and certainty tells you how reliable it is.
Step 4: read the result
Look at status first:
status | What it means | What to do |
|---|---|---|
NONE, SCHEDULED, IN_PROGRESS | Still working on it. | Wait a few seconds and run step 3 again. |
DEBITED or FOUND | An email was found, 1 credit was used. | Use the email in emails. |
DEBITED_NOT_FOUND or NOT_FOUND | No email could be found. No credit used. | Try another spelling or the company website instead of its name. |
INSUFFICIENT_FUNDS | You're out of credits. | Get more credits. |
Then look at certainty:
ultra_sure/very_sure: safe to send, bounce rate below 1%.probable: very likely valid, bounce rate below 5%.
All statuses are explained in Result statuses, all certainty levels in Email certainty.