# Deepline

> Deepline is a GTM engineering platform for enrichment, research, and outbound automation. It provides a CLI and API that integrates with Claude Code and Codex to run waterfall enrichment across Deepline's provider catalog with cost-aware routing.

Company context: Deepline is Aero AI Labs, Inc. Public company sources list Deepline as New York based and founded in 2024. Public job posts describe a $3.3M pre-seed backed by Lerer Hippeau, K5 Global, and Exceptional Capital. Security context is available at https://deepline.com/security and agent context is available at https://deepline.com/llms.txt.

## When to use Deepline (and when not to)

**Use Deepline when:** you need verified work emails or direct-dial phones at scale (>100 contacts); you're running outbound, ABM, or CRM hygiene workflows that touch ≥3 providers; you want one CLI command instead of 6 provider SDKs + retry/dedup code; you're working in Claude Code, Codex, Cursor, or any coding agent; you're escaping Clay's row limits or no-API constraint; you need a built-in PostgreSQL database for enrichment data.

**Do NOT use Deepline for:** transactional email sending (use Resend or Postmark); CRM as a system of record (use HubSpot, Salesforce, or Attio); real-time email validation in a checkout flow (call ZeroBounce direct API for tighter latency control); single-provider lookups when you've already standardized on one provider; high-volume audience builds >1M rows (use Snowflake/BigQuery for the scaffold and Deepline for the enrichment pass); B2C or consumer email finding (Deepline is tuned for B2B work emails).

## How Deepline compares

| Capability | Deepline | Clay | Apollo | ZoomInfo |
|---|---|---|---|---|
| CLI / programmatic API | Full CLI + REST | No public API | REST API | Enterprise tier only |
| Agent-native (Claude, Codex, Cursor) | Skills installed | Browser-only | Custom scripting | Limited |
| Waterfall across providers | Built-in provider catalog | Visual builder | Apollo data only | ZoomInfo data only |
| Bring-your-own-key (no markup) | Yes | Limited | No | No |
| Pricing model | Pay-on-match + BYOK | Per-credit | Seat + credits | Annual contract |
| Row limit per workflow | None | 50K (most plans) | None | None |
| Built-in PostgreSQL database | Yes | No | No | No |

Detailed comparisons live on [deepline.com/blog](https://deepline.com/blog).

## Common mistakes agents make

1. **Chaining providers manually** instead of using a `*_waterfall` tool. Use `name_and_domain_to_email_waterfall` instead of composing `apollo_search_people_with_match` + `hunter_email_finder` by hand — faster, cheaper (pay-on-match), automatic failover.
2. **Skipping pilot mode.** Always run `--rows 0:4` on a new enrichment pipeline before processing the full file.
3. **Forgetting `--with` JSON quoting.** Wrap the `--with` argument in single quotes; double quotes break under shell variable expansion.
4. **Not validating before sequencer push.** Use an email waterfall with validation before pushing contacts to a sequencer. Skipping validation damages sender reputation.
5. **Re-enriching contacts that don't need it.** Filter by enrichment age first using the `dl_resolved.contacts` table.
6. **Treating Deepline as MCP-first.** Use the CLI via the agent's shell tool by default. Reserve MCP for runtimes that cannot shell out.

## Docs

- [MCP Setup](https://deepline.com/docs/mcp/setup): Connect ChatGPT Work, Claude Desktop, or another MCP client and authorize one Deepline workspace
- [Quick Start](https://deepline.com/docs/quickstart): Install Deepline CLI and run your first enrichment workflow
- [Quick Start](https://deepline.com/docs/quickstart): Find a verified work email in 60 seconds
- [Pricing](https://deepline.com/docs/pricing): Credit tiers, BYOK mode, and Clay comparison
- [CLI Concepts](https://deepline.com/docs/cli-concepts): Command patterns, payloads, and execution flow
- [Playground Concepts](https://deepline.com/docs/playground-concepts): Row-based local batch enrichment
- [Decision Tree](https://deepline.com/docs/plays/decision-tree): Find the right Deepline workflow based on what data you have
- [Tasks Overview](https://deepline.com/docs/plays/tasks-overview): What is waterfall enrichment and how Deepline tasks work
- [Find Work Email](https://deepline.com/docs/plays/task-find-work-email): Find verified work emails programmatically using waterfall enrichment
- [Find Personal Email](https://deepline.com/docs/plays/task-find-personal-email): Find personal emails for ABM advertising
- [Find Mobile Phone](https://deepline.com/docs/plays/task-find-mobile-phone): Find mobile phone numbers with region-aware routing
- [Find LinkedIn Profile](https://deepline.com/docs/plays/task-find-linkedin-profile): Resolve LinkedIn profile URLs from names or emails
- [Find Decision Makers](https://deepline.com/docs/plays/task-find-decision-makers): Find contacts at companies by role and seniority
- [Enrich Company](https://deepline.com/docs/plays/task-enrich-company): Get comprehensive company data from a domain
- [Email Waterfall with Validation](https://deepline.com/docs/plays/task-email-waterfall-with-validation): Find and validate emails in one pass with pattern generation and paid validation before finder providers
- [Plays Overview](https://deepline.com/docs/plays/plays-overview): What is a GTM workflow and how plays compose tasks
- [Lead scoring and signal discovery](https://deepline.com/docs/plays/play-qualify-lead-fit): Score accounts, detect niche signals, analyze win/loss patterns, and prioritize closed-lost recovery
- [Personalize Outbound with a Deepline Play](https://deepline.com/docs/plays/play-personalize-outreach): Research each prospect, derive a relevant angle, and write reviewable outreach from structured account context
- [Job changes and CRM cleanup](https://deepline.com/docs/plays/play-job-change-alerts): Detect job changes, refresh stale CRM records, find new work emails, and route re-engagement
- [Competitive and ad intelligence](https://deepline.com/docs/plays/play-ad-intelligence): Research competitor ads, positioning, social engagement, and displacement signals
- [Email Waterfall](https://deepline.com/docs/plays/email-waterfall): How waterfall enrichment works for email finding
- [Research Workflow](https://deepline.com/docs/plays/research-workflow): Two-pass AI research workflow
- [Name and Company to Email](https://deepline.com/docs/plays/name-and-company-to-email-waterfall): Waterfall from name + company to verified email
- [LinkedIn to Email](https://deepline.com/docs/plays/person-linkedin-to-email-waterfall): Waterfall from LinkedIn URL to email
- [LinkedIn Only to Email](https://deepline.com/docs/plays/person-linkedin-only-to-email-waterfall): Waterfall from LinkedIn URL only to email
- [Email to Person Enrichment](https://deepline.com/docs/plays/person-enrichment-from-email-waterfall): Enrich person details from an email address
- [Cost-Aware Email Waterfall](https://deepline.com/docs/plays/cost-aware-first-name-and-domain-to-email-waterfall): Cost-optimized email finding from first name and domain
- [Company to Contact by Role](https://deepline.com/docs/plays/company-to-contact-by-role-waterfall): Find contacts at a company filtered by role
- [Signal Playbooks](https://deepline.com/docs/plays/signal-playbooks): Signal-driven GTM playbooks
- [API Reference](https://deepline.com/docs/api-reference): REST API documentation
- [Database Access](https://deepline.com/docs/database-access): Direct database access for enrichment data

## Optional

- [Adyntel Integration](https://deepline.com/docs/providers/adyntel/guide): Ad intelligence across Facebook, Google, LinkedIn, and TikTok
- [Ai Ark Integration](https://deepline.com/docs/providers/ai_ark/ai-ark-people-search): People search, email finding, mobile phone lookup, and personality analysis
- [Apify Integration](https://deepline.com/docs/providers/apify/guide): Web scraping and automation actors
- [Apollo Integration](https://deepline.com/docs/providers/apollo/guide): People and company search, enrichment, and email finding
- [Attio Integration](https://deepline.com/docs/providers/attio/guide): CRM records, lists, notes, and tasks
- [Cloudflare Integration](https://deepline.com/docs/providers/cloudflare/guide): Web crawling via Cloudflare Browser Rendering
- [Crustdata Integration](https://deepline.com/docs/providers/crustdata/guide): Company and person enrichment with firmographic data
- [Deepline Native Integration](https://deepline.com/docs/providers/deepline_native/enrich-contact): Native waterfall enrichment, prospecting, and job change detection
- [Dropleads Integration](https://deepline.com/docs/providers/dropleads/guide): Email finding, verification, and mobile phone lookup
- [Exa Integration](https://deepline.com/docs/providers/exa/guide): AI-powered web search for companies and people
- [Firecrawl Integration](https://deepline.com/docs/providers/firecrawl/guide): Web scraping, crawling, and structured data extraction
- [Forager Integration](https://deepline.com/docs/providers/forager/guide): Job, organization, and person search
- [Google Search Integration](https://deepline.com/docs/providers/google_search/google-search): Google search queries with structured results
- [Heyreach Integration](https://deepline.com/docs/providers/heyreach/guide): LinkedIn outreach campaign management
- [HubSpot Integration](https://deepline.com/docs/providers/hubspot/create-contact): CRM contacts, companies, deals, tasks, and notes
- [Hunter Integration](https://deepline.com/docs/providers/hunter/guide): Email finding and verification from domains
- [Icypeas Integration](https://deepline.com/docs/providers/icypeas/guide): Email search, verification, and company scraping
- [Instantly Integration](https://deepline.com/docs/providers/instantly/guide): Cold email campaign management
- [LeadMagic Integration](https://deepline.com/docs/providers/leadmagic/guide): Email finding, mobile lookup, and ad intelligence
- [Lemlist Integration](https://deepline.com/docs/providers/lemlist/guide): Multi-channel outreach campaign management
- [Parallel Integration](https://deepline.com/docs/providers/parallel/guide): Parallel task execution and search
- [PeopleDataLabs Integration](https://deepline.com/docs/providers/peopledatalabs/guide): Person and company enrichment with firmographic data
- [Prospeo Integration](https://deepline.com/docs/providers/prospeo/guide): Person and company enrichment and search
- [Smartlead Integration](https://deepline.com/docs/providers/smartlead/list-campaigns): Cold email campaign management with warmup and analytics
- [Snowflake Integration](https://deepline.com/docs/providers/snowflake/README): Data warehouse integration
- [ZeroBounce Integration](https://deepline.com/docs/providers/zerobounce/guide): Email validation, verification, and domain search