# Icypeas API > Icypeas API documentation. Find and verify professional email addresses, scan domains, scrape profiles and companies and search a B2B lead database, with or without code. Key facts for AI agents and developers: - Base URL: `https://app.icypeas.com/api`. Every endpoint is called with HTTPS and a JSON body. - Authentication: header `Authorization: ` (the key alone, no "Bearer" prefix) plus `Content-Type: application/json`. Users get their key at https://app.icypeas.com (API section). - Email search, email verification and domain search are asynchronous. `POST /email-search` (or `/email-verification`, `/domain-search`) returns `item._id`. Then call `POST /bulk-single-searchs/read` with `{"id": "<_id>"}` every few seconds until `items[0].status` is no longer `NONE`, `SCHEDULED` or `IN_PROGRESS`. Webhooks are the recommended alternative to polling. - Found emails are in `items[0].results.emails[]` with a `certainty` (`ultra_sure`, `very_sure`, `probable`, `not_found`, `undeliverable`). - Input mistakes return HTTP 200 with `{"success": false, "validationErrors": [...]}`. Wrong or missing key returns 401, too many calls return 429. - Machine-readable spec: https://api-doc.icypeas.com/openapi.json. Every page below is also available as Markdown by adding `.md` to its URL. All pages in one file: https://api-doc.icypeas.com/llms-full.txt ## Get started - [Icypeas API overview](https://api-doc.icypeas.com/overview.md): What you can do with the Icypeas API, how much it costs and the fastest way to get started, with or without code. - [Quickstart: find your first email in 5 minutes](https://api-doc.icypeas.com/getting-started.md): Step-by-step guide to find a professional email address with the Icypeas API in 5 minutes, even if you have never used an API before. - [Quickstart: verify an email address](https://api-doc.icypeas.com/quickstart/verify-email.md): Check whether a professional email address really exists with the Icypeas API, in three copy-paste steps. Costs 0.1 credit per verification. - [Get your API key](https://api-doc.icypeas.com/api-key.md): Where to find your Icypeas API key and API secret, how to activate API access and how to keep your key safe. - [How the Icypeas API works](https://api-doc.icypeas.com/how-it-works.md): Searches on the Icypeas API are asynchronous. Learn the send, wait, read cycle, how to get results with polling or webhooks, and which tasks are available. - [Use the Icypeas API with AI agents](https://api-doc.icypeas.com/ai-agents.md): Give ChatGPT, Claude, Cursor or any AI agent the Icypeas docs in one link. llms.txt, llms-full.txt, Markdown pages and an OpenAPI 3.1 spec are available. ## No-code - [Use the Icypeas API without code](https://api-doc.icypeas.com/no-code.md): Find and verify emails with the Icypeas API from Google Sheets, Make, Zapier or n8n. Step-by-step guides for non-developers. - [Find and verify emails in Google Sheets](https://api-doc.icypeas.com/no-code/google-sheets.md): Copy-paste a ready-made Apps Script into Google Sheets to find or verify professional emails for every row of your sheet with the Icypeas API. No coding needed. - [Find and verify emails with Make](https://api-doc.icypeas.com/no-code/make.md): Connect the Icypeas API to Make (formerly Integromat) with the HTTP module to find or verify professional emails in any scenario. - [Find and verify emails with Zapier](https://api-doc.icypeas.com/no-code/zapier.md): Use Webhooks by Zapier to call the Icypeas API and find or verify a professional email every time a new lead arrives. - [Find and verify emails with n8n](https://api-doc.icypeas.com/no-code/n8n.md): Call the Icypeas API from n8n with the HTTP Request and Wait nodes to find or verify professional emails in your workflows. ## Essentials - [Authentication](https://api-doc.icypeas.com/authentication.md): Authenticate Icypeas API requests with your API key in the Authorization header, or sign each request with HMAC-SHA1 and your API secret for extra security. - [Errors and troubleshooting](https://api-doc.icypeas.com/errors.md): Every error the Icypeas API can return, what it means and how to fix it. HTTP 401 and 429 errors, validation errors, unpaid subscription and search statuses. - [Result statuses](https://api-doc.icypeas.com/statuses.md): Every status an Icypeas search can have (NONE, SCHEDULED, IN_PROGRESS, FOUND, DEBITED, NOT_FOUND…), what it means and what to do next. - [Email certainty levels](https://api-doc.icypeas.com/certainties.md): What the certainty levels of the Icypeas API mean (ultra_sure, very_sure, probable, undeliverable, not_found) and which emails are safe to send to. - [Credit costs](https://api-doc.icypeas.com/credits.md): How many Icypeas credits each API endpoint uses. Email search costs 1 credit per email found, email verification 0.1 credit, lead database 0.02 credit per result. - [Rate limits](https://api-doc.icypeas.com/rate-limits.md): How many requests per second or per minute each Icypeas API endpoint accepts, and how to handle HTTP 429 errors. - [Pagination](https://api-doc.icypeas.com/pagination.md): How to page through long lists of results with the Icypeas API, using the sorts array or the pagination token. - [MX providers](https://api-doc.icypeas.com/mx-providers.md): The list of email hosting providers (Google, Microsoft, OVH, Proofpoint…) the Icypeas API can return in the mxProvider field. ## Resources - [Frequently asked questions](https://api-doc.icypeas.com/faq.md): Answers to the most common questions about the Icypeas API, pricing, speed, limits, webhooks and no-code tools. - [Changelog](https://api-doc.icypeas.com/changelog.md): All the changes made to the Icypeas API and its documentation, newest first. - [Get help](https://api-doc.icypeas.com/support.md): How to contact Icypeas support about the API, and what to include in your message to get a fast answer. ## API reference - [API reference](https://api-doc.icypeas.com/reference/overview.md): Base URL, authentication, request and response format of the Icypeas REST API, and the list of every endpoint. ## API reference: Emails - [Email search: find a professional email](https://api-doc.icypeas.com/reference/email-search.md): POST /email-search: find the professional email address of a person from their first name, last name and company name or domain. 1 credit per email found. - [Email verification: check that an email exists](https://api-doc.icypeas.com/reference/email-verification.md): POST /email-verification: check whether a professional email address exists and is safe to send to. 0.1 credit per verification. - [Domain search: find the role-based emails of a company](https://api-doc.icypeas.com/reference/domain-search.md): POST /domain-search: scan a domain or company to find its role-based email addresses such as contact@, sales@ or hello@. 1 credit if emails are found. - [Bulk search: find or verify up to 5,000 emails per call](https://api-doc.icypeas.com/reference/bulk-search.md): POST /bulk-search: find emails, verify emails or scan domains for up to 5,000 rows in a single API call, with custom ids and webhooks. ## API reference: Results - [Read search results](https://api-doc.icypeas.com/reference/get-results.md): POST /bulk-single-searchs/read: get the result of a search by id, or list your single and bulk search results with filters and pagination. - [Bulk search progress and stats](https://api-doc.icypeas.com/reference/bulk-files.md): POST /search-files/read: follow the progress of your bulk searches and get their statistics (rows done, emails found by certainty). ## API reference: Webhooks - [Webhooks: get results pushed to you](https://api-doc.icypeas.com/reference/webhooks.md): Have Icypeas call your server, Zapier, Make or n8n as soon as a search or a bulk search is done, instead of polling. Setup and signature verification. - [Webhook: search item processed](https://api-doc.icypeas.com/reference/webhook-search-item.md): Payload of the webhook Icypeas sends each time a single search, or a row of a bulk search, is processed. Contains the emails found, certainty and status. - [Webhook: bulk search done](https://api-doc.icypeas.com/reference/webhook-bulk-done.md): Payload of the webhook Icypeas sends when a whole bulk search is finished, with statistics and optionally every result. ## API reference: Profiles & companies - [Profile scraper: get a person's data from a profile URL](https://api-doc.icypeas.com/reference/scrape-profile.md): GET /scrape/profile: turn a profile URL into structured data (name, headline, current job, experience, education, skills). 1.5 credits per profile found. Bulk version for 50 profiles per call. - [Company scraper: get a company's data from its page URL](https://api-doc.icypeas.com/reference/scrape-company.md): GET /scrape/company: turn a company page URL into structured data (industry, headcount, location, website, growth). 0.5 credit per company found. Bulk version for 50 companies per call. - [Profile URL finder: find a person's profile URL](https://api-doc.icypeas.com/reference/find-profile-url.md): POST /url-search/profile: find the profile URL of a person from their name, company and job title. 1 credit per URL found. Bulk version for 50 people per call. - [Company URL finder: find a company's page URL](https://api-doc.icypeas.com/reference/find-company-url.md): POST /url-search/company: find the company page URL of a company from its name or website. 1 credit per URL found. Bulk version for 50 companies per call. - [Reverse email lookup: find the person behind an email](https://api-doc.icypeas.com/reference/reverse-email-lookup.md): POST /reverse-email-lookup: find the profile URL of the person behind a professional email address. 10 credits per profile found. Bulk version for 50 emails per call. ## API reference: Lead database - [Find people: search the B2B lead database](https://api-doc.icypeas.com/reference/find-people.md): POST /find-people: search millions of professionals by job title, company, location, skills, seniority and more. Count matches for free, then fetch them for 0.02 credit each. - [Find companies: search the B2B company database](https://api-doc.icypeas.com/reference/find-companies.md): POST /find-companies: search companies by industry, location, headcount, growth, revenue and keywords. Count matches for free, then fetch them for 0.02 credit each. ## API reference: Account - [Subscription and remaining credits](https://api-doc.icypeas.com/reference/subscription.md): POST /a/actions/subscription-information: get your current Icypeas plan, its renewal date and your remaining credits. Free. - [Change or cancel your plan](https://api-doc.icypeas.com/reference/change-plan.md): How to upgrade, downgrade or cancel your Icypeas subscription, and when the change takes effect. ## Optional - [OpenAPI specification](https://api-doc.icypeas.com/openapi.json): every endpoint, parameter and response as OpenAPI 3.1 - [Icypeas website](https://www.icypeas.com) - [Icypeas app](https://app.icypeas.com): create an account and get an API key