> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Icypeas API Guide for GTM Workflows

> Use email-search for individual email discovery and it will wait for the final result by default. Includes inputs, outputs, costs, and Deepline CLI examples.

## Playbook

# Icypeas Workflow Guidance

* **Always start with counts.** Run `icypeas_count_people` or `icypeas_count_companies` before paid find operations. These are free and let you estimate result volume, refine filters, and avoid wasting credits on overly broad queries.
* **Email search is async.** `icypeas_email_search` returns a `SCHEDULED` status immediately. Poll `icypeas_read_results` with the returned `_id` to get the final email. Plan for this delay in workflows.
* **Use bulk search for volume.** When processing more than a handful of records, prefer `icypeas_bulk_search` over individual `icypeas_email_search` calls. Bulk supports up to 5,000 rows per batch. Monitor progress via `icypeas_read_bulk_files`.
* **Verify before sending.** Always run `icypeas_email_verification` on discovered emails before outbound. It costs only 0.1 Icypeas provider credits. Treat `NOT_FOUND` and `DEBITED_NOT_FOUND` as non-deliverable.
* **LinkedIn scraping is powerful but costs more.** `icypeas_scrape_profile` (1.5 credits) returns rich contact data including phone numbers and verified emails. `icypeas_scrape_company` (0.5 credits) is cheaper for company-level data.
* **Find-people supports 16 filters.** Use include/exclude arrays for precise targeting: job title, company, location, skills, languages, school, keywords, and more. Start broad with count, then narrow.
* **Pagination uses token-based cursors.** For `icypeas_find_people` and `icypeas_find_companies`, pass the `token` from the previous response into the next request's `pagination.token`. Page size max is 200.
* **Free operations for planning:** `icypeas_count_people`, `icypeas_count_companies`, `icypeas_read_results`, and `icypeas_read_bulk_files` cost zero credits. Use them liberally.
* **Check account status.** Use your internal usage dashboard before large operations.