# 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 25+ data providers with cost-aware routing.

## 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, 25+ integrations | 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 (Clay markup) | Seat + credits | Annual contract ($15K+) |
| 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_people_search` + `hunter_email_finder` by hand — faster, cheaper (pay-on-match), automatic failover.
2. **Skipping pilot mode.** Always run `--rows 0:5` on a new 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.** Pattern: `enrich → validate → filter → push`. 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.** CLIs use 4-32x fewer tokens than MCP for equivalent calls (StackOne benchmark, 2026). Use the CLI via the agent's shell tool; reserve MCP for runtimes that can't shell out.

## Docs

- [Quick Start](https://docs.deepline.com/quickstart): Install Deepline CLI and run your first enrichment workflow
- [Install](https://docs.deepline.com/install): CLI installation for macOS and Linux
- [Quick Start](https://docs.deepline.com/quickstart): Find a verified work email in 60 seconds
- [Pricing](https://docs.deepline.com/pricing): Credit tiers, BYOK mode, and Clay comparison
- [CLI Concepts](https://docs.deepline.com/cli-concepts): Command patterns, payloads, and execution flow
- [Playground Concepts](https://docs.deepline.com/playground-concepts): Row-based local batch enrichment
- [Decision Tree](https://docs.deepline.com/plays/decision-tree): Find the right Deepline workflow based on what data you have
- [Tasks Overview](https://docs.deepline.com/plays/tasks-overview): What is waterfall enrichment and how Deepline tasks work
- [Find Work Email](https://docs.deepline.com/plays/task-find-work-email): Find verified work emails programmatically using waterfall enrichment
- [Find Personal Email](https://docs.deepline.com/plays/task-find-personal-email): Find personal emails for ABM advertising
- [Find Mobile Phone](https://docs.deepline.com/plays/task-find-mobile-phone): Find mobile phone numbers with region-aware routing
- [Find LinkedIn Profile](https://docs.deepline.com/plays/task-find-linkedin-profile): Resolve LinkedIn profile URLs from names or emails
- [Find Decision Makers](https://docs.deepline.com/plays/task-find-decision-makers): Find contacts at companies by role and seniority
- [Enrich Company](https://docs.deepline.com/plays/task-enrich-company): Get comprehensive company data from a domain
- [Email Waterfall with Validation](https://docs.deepline.com/plays/task-email-waterfall-with-validation): Find and validate emails in one pass with free patterns first
- [Plays Overview](https://docs.deepline.com/plays/plays-overview): What is a GTM workflow and how plays compose tasks
- [Company Research Brief](https://docs.deepline.com/plays/play-company-research-brief): Generate AI-powered company research briefs
- [Competitive Landscape](https://docs.deepline.com/plays/play-competitive-landscape): Analyze competitor positioning programmatically
- [Qualify Lead Fit](https://docs.deepline.com/plays/play-qualify-lead-fit): Score leads against your ICP with AI
- [Personalize Outreach](https://docs.deepline.com/plays/play-personalize-outreach): Research contacts and generate personalized cold emails
- [Classify Company Signals](https://docs.deepline.com/plays/play-classify-company-signals): Detect expansion, hiring, and acquisition signals
- [Build Prospect List](https://docs.deepline.com/plays/play-build-prospect-list): Build a prospect list end-to-end with AI
- [Account Mapping](https://docs.deepline.com/plays/play-account-mapping): Map stakeholders at target accounts
- [Job Change Alerts](https://docs.deepline.com/plays/play-job-change-alerts): Detect job changes and flag re-engagement opportunities
- [Ad Intelligence](https://docs.deepline.com/plays/play-ad-intelligence): Analyze competitor ad spend across platforms
- [Competitive Mentions Campaign](https://docs.deepline.com/plays/competitive-mentions-campaign): Campaign triggered by competitor mentions
- [Multi-Signal Outreach](https://docs.deepline.com/plays/multi-signal-outreach): Outreach driven by multiple buying signals
- [Email Waterfall](https://docs.deepline.com/plays/email-waterfall): How waterfall enrichment works for email finding
- [Research Workflow](https://docs.deepline.com/plays/research-workflow): Two-pass AI research workflow
- [Name and Company to Email](https://docs.deepline.com/plays/name-and-company-to-email-waterfall): Waterfall from name + company to verified email
- [LinkedIn to Email](https://docs.deepline.com/plays/person-linkedin-to-email-waterfall): Waterfall from LinkedIn URL to email
- [LinkedIn Only to Email](https://docs.deepline.com/plays/person-linkedin-only-to-email-waterfall): Waterfall from LinkedIn URL only to email
- [Email to Person Enrichment](https://docs.deepline.com/plays/person-enrichment-from-email-waterfall): Enrich person details from an email address
- [Cost-Aware Email Waterfall](https://docs.deepline.com/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://docs.deepline.com/plays/company-to-contact-by-role-waterfall): Find contacts at a company filtered by role
- [Signal Playbooks](https://docs.deepline.com/plays/signal-playbooks): Signal-driven GTM playbooks
- [CRM Cleaning Job Changes](https://docs.deepline.com/plays/crm-cleaning-job-changes): Clean CRM data by detecting job changes
- [CRM Job Change Detector](https://docs.deepline.com/plays/crm-job-change-detector): Detect when contacts change jobs
- [Win/Loss Signals](https://docs.deepline.com/plays/win-loss-signals): Analyze win/loss signals for deal intelligence
- [Closed-Lost Recovery](https://docs.deepline.com/plays/closed-lost-recovery): Re-engage closed-lost opportunities with signals
- [Account Scoring](https://docs.deepline.com/plays/account-scoring): Score accounts using enrichment signals
- [API Reference](https://docs.deepline.com/api-reference): REST API documentation
- [Database Access](https://docs.deepline.com/database-access): Direct database access for enrichment data

## Optional

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