Copy page

Tomba CLI

Bulk CSV Processing

Process a CSV file in bulk with concurrent workers. Auto-maps columns or use custom mapping.

Usage

Code
tomba bulk --file <csv_file> --type <operation>

Flags

Flag	Description	Default
--file	Input CSV file path (required)	—
--type	Operation type (see table below)	enrich
--column	Column name for email or domain (auto-detected if empty)	—
--domain-col	Column name for domain (for finder type)	—
--first-col	Column name for first name (for finder type)	—
--last-col	Column name for last name (for finder type)	—
--url-col	Column name for URL (for author/linkedin type)	—
--concurrency	Number of concurrent workers (0 = auto from plan, max 60)	0

Supported Operations

Type	Description	Input Column
enrich	Enrich emails with additional data	email
verify	Verify email deliverability	email
finder	Find emails from name and domain	domain + first + last
search	Search emails by domain	domain
author	Find emails from blog post URLs	url
linkedin	Find emails from LinkedIn URLs	url
phone	Find phone numbers from emails	email
sources	Find email sources	email

Examples

Code
# Basic enrichment (auto-detects email column)
tomba bulk --file contacts.csv --type enrich

# Verify with explicit column
tomba bulk --file leads.csv --type verify --column "Email Address"

# Email finder with name + domain columns
tomba bulk --file prospects.csv --type finder --domain-col company --first-col first --last-col last

# Domain search with output file
tomba bulk --file domains.csv --type search --column domain -o results.csv

# Author finder from URLs
tomba bulk --file articles.csv --type author --url-col "Article URL"

# LinkedIn finder
tomba bulk --file profiles.csv --type linkedin --url-col "LinkedIn URL"

# Custom concurrency
tomba bulk --file contacts.csv --type verify --concurrency 10

Concurrency

The worker count is automatically determined by your plan:

Plan	Workers
Free	1
Basic	3
Growth	5
Pro	8
Pay-as-you-go 20k	10
50k+ plans	60

Override with --concurrency (max 60).

Demo

Example Output

Code
✓ Authenticated as info@tomba.io

  Columns: email, first_name, last_name, company
  Rows: 1000

  ✓ Using column 'email' for email

  Processing: ██████████████████████████████ 100% (1000/1000)

✓ 847/1000 emails found (84.7% hit rate)
✓ Results saved to contacts_enriched.csv