Skip to content

CLI_DOCUMENTATION.md

Latest commit

 

History

History
934 lines (675 loc) · 29.4 KB

CLI_DOCUMENTATION.md

File metadata and controls

934 lines (675 loc) · 29.4 KB
Raw

Explorium CLI Documentation

A command-line interface for interacting with the Explorium API.

Installation

One-liner (recommended)

Pre-built binaries are available from GitHub Releases. The installer auto-detects your platform:

curl -fsSL https://raw.githubusercontent.com/haroExplorium/explorium-cli/main/install.sh | bash

This installs to ~/.local/bin/explorium and adds it to your PATH.

Supported platforms:

Platform Architecture Binary
macOS arm64 (Apple Silicon) explorium-darwin-arm64
Linux amd64 / x86_64 explorium-linux-amd64
Linux arm64 / aarch64 explorium-linux-arm64

From source

git clone https://github.com/haroExplorium/explorium-cli.git
cd explorium-cli
pip install -e .

Manual binary install

# Copy binary to system path
sudo cp dist/explorium /usr/local/bin/

# Or add to PATH
export PATH="$PATH:/path/to/dist"

Global Options

These options apply to all commands and must be placed BEFORE the command:

Option Description
-o, --output Output format: json (default), table, or csv
--output-file PATH Write output to file (clean JSON/CSV, no formatting)
-c, --config Path to config file (default: ~/.explorium/config.yaml)
--help Show help message

Example:

# Correct - global option before command
explorium -o table businesses search --country us

# Write output to file (clean JSON/CSV, no formatting)
explorium --output-file results.json businesses search --country us

# Wrong - will fail
explorium businesses search --country us -o table

Configuration Commands

explorium config init

Initialize configuration with your API key.

# Set up your API key
explorium config init --api-key YOUR_API_KEY

explorium config set

Set configuration values (positional KEY VALUE arguments).

# Set default output format
explorium config set default_output table

# Set default page size
explorium config set default_page_size 50

# Set base URL
explorium config set base_url https://api.explorium.ai/v1

explorium config show

Display current configuration.

explorium config show

Business Commands

explorium businesses match

Match businesses to get unique business IDs.

# Match by company name
explorium businesses match --name "Salesforce"

# Match by domain
explorium businesses match --domain "salesforce.com"

# Match by LinkedIn URL
explorium businesses match --linkedin "https://linkedin.com/company/salesforce"

# Batch match from JSON file
explorium businesses match --file companies.json

# Batch match from CSV file
explorium businesses match --file companies.csv

# Show match statistics
explorium businesses match --file companies.csv --summary

# Output only matched IDs (one per line, pipeable)
explorium businesses match --file companies.csv --ids-only

# Override output format for this command
explorium businesses match --file companies.csv --format csv

explorium businesses search

Search and filter businesses.

# Search by country (alpha-2 codes)
explorium businesses search --country us

# Search by multiple countries
explorium businesses search --country "us,ca,gb"

# Search by company size
explorium businesses search --size "51-200"

# Search by revenue range
explorium businesses search --revenue "10M-25M"

# Search by technologies
explorium businesses search --tech "Python,AWS"

# Combined filters with pagination
explorium businesses search --country us --size "51-200" --page 1 --page-size 50

# Auto-paginate to collect a specific total
explorium businesses search --country us --total 500

Size ranges: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+

Revenue ranges: 0-500K, 500K-1M, 1M-5M, 5M-10M, 10M-25M, 25M-75M, 75M-200M, 200M-500M, 500M-1B, 1B-10B, 10B+

explorium businesses enrich

Enrich a single business with firmographics data. You can provide either a business ID directly, or use match parameters (name, domain, linkedin) to automatically resolve the ID.

Using ID directly:

# Enrich Salesforce by ID
explorium businesses enrich --id 39ae2ed11b14a4ccb41d35e9d1ba5d11

# Enrich Colgate-Palmolive by ID
explorium businesses enrich --id 1006ff12c465532f8c574aeaa4461b16

Using match parameters (enrich without knowing the ID):

# Enrich Salesforce by company name
explorium businesses enrich --name "Salesforce"

# Enrich Google by domain
explorium businesses enrich --domain "google.com"

# Enrich Colgate-Palmolive by LinkedIn URL
explorium businesses enrich --linkedin "https://linkedin.com/company/colaboratoolive"

# Combine match parameters for better accuracy
explorium businesses enrich --name "Starbucks" --domain "starbucks.com"

Match confidence threshold:

By default, the CLI requires 80% match confidence. You can adjust this:

# Accept lower confidence matches (useful for less common companies)
explorium businesses enrich --name "Acme Corp" --min-confidence 0.5

# Require higher confidence (more strict matching)
explorium businesses enrich --name "Apple" --min-confidence 0.95

When a match confidence is below the threshold, the CLI shows suggestions:

Error: Best match confidence (0.65) is below threshold (0.80). Found 3 potential match(es).

Suggestions (try --min-confidence to lower threshold):
  1. Acme Corporation (ID: abc123..., confidence: 0.65)
  2. Acme Industries (ID: def456..., confidence: 0.52)
  3. Acme LLC (ID: ghi789..., confidence: 0.48)

Business Enrichment Types

The CLI supports multiple enrichment types for businesses:

Command Description
enrich Firmographics data (basic company info)
enrich-tech Technographics data (tech stack)
enrich-financial Financial metrics and indicators
enrich-funding Funding and acquisition data
enrich-workforce Workforce trends and department distribution
enrich-traffic Website traffic metrics
enrich-social Social media / LinkedIn posts
enrich-ratings Employee ratings (Glassdoor-style)
enrich-keywords Website keyword search (requires --keywords)
enrich-challenges Business challenges (public companies, 10-K)
enrich-competitive Competitive landscape (public companies, 10-K)
enrich-strategic Strategic insights (public companies, 10-K)
enrich-website-changes Website changes tracking
enrich-webstack Website technology stack
enrich-hierarchy Company hierarchy (parent/subsidiaries)
enrich-intent Bombora intent signals

Using ID:

# Tech stack for Salesforce
explorium businesses enrich-tech --id 39ae2ed11b14a4ccb41d35e9d1ba5d11

# Financial metrics for Colgate-Palmolive
explorium businesses enrich-financial --id 1006ff12c465532f8c574aeaa4461b16

# Funding and acquisitions for Google
explorium businesses enrich-funding --id c71497b026909c74b4ab3a4fbfcd122a

Using match parameters (no ID required):

# Tech stack - what technologies does Salesforce use?
explorium businesses enrich-tech --name "Salesforce"
explorium businesses enrich-tech --domain "salesforce.com"

# Financial metrics for Microsoft
explorium businesses enrich-financial --name "Microsoft" --domain "microsoft.com"

# Funding and acquisitions for Stripe
explorium businesses enrich-funding --name "Stripe"

# Workforce trends for Amazon
explorium businesses enrich-workforce --domain "amazon.com"

# Website traffic for Netflix
explorium businesses enrich-traffic --name "Netflix"

# LinkedIn posts for HubSpot
explorium businesses enrich-social --name "HubSpot"

# Employee ratings for Glassdoor
explorium businesses enrich-ratings --domain "glassdoor.com"

# Website keyword search - does Apple mention "AI" on their website?
explorium businesses enrich-keywords --name "Apple" --keywords "AI,machine learning,privacy"

# Business challenges for Tesla (public company, from 10-K filings)
explorium businesses enrich-challenges --name "Tesla"

# Competitive landscape for Coca-Cola (public company)
explorium businesses enrich-competitive --name "Coca-Cola"

# Strategic insights for JPMorgan (public company)
explorium businesses enrich-strategic --name "JPMorgan Chase"

# Website changes tracking for Shopify
explorium businesses enrich-website-changes --domain "shopify.com"

# Webstack - what does Airbnb's website run on?
explorium businesses enrich-webstack --name "Airbnb"

# Company hierarchy for Johnson & Johnson
explorium businesses enrich-hierarchy --name "Johnson & Johnson"

# Bombora intent signals for Zoom
explorium businesses enrich-intent --name "Zoom Video Communications"

explorium businesses bulk-enrich

Bulk enrich multiple businesses (up to 50).

Using IDs:

# Enrich Salesforce, Google, and Colgate Palmolive by IDs
explorium businesses bulk-enrich --ids "39ae2ed11b14a4ccb41d35e9d1ba5d11,c71497b026909c74b4ab3a4fbfcd122a,1006ff12c465532f8c574aeaa4461b16"

# From a file with IDs (one per line)
explorium businesses bulk-enrich --file business_ids.txt

Using match file (no IDs required):

Create a JSON file companies_to_enrich.json:

[
  {"name": "Salesforce", "domain": "salesforce.com"},
  {"name": "HubSpot", "domain": "hubspot.com"},
  {"name": "Zendesk"},
  {"domain": "freshworks.com"},
  {"linkedin_url": "https://linkedin.com/company/intercom"}
]

Then run:

# Bulk enrich by resolving company names/domains to IDs automatically
explorium businesses bulk-enrich --match-file companies_to_enrich.json

# With lower confidence threshold
explorium businesses bulk-enrich --match-file companies_to_enrich.json --min-confidence 0.6

# Show match/enrichment statistics
explorium businesses bulk-enrich --match-file companies_to_enrich.json --summary

# Override output format
explorium businesses bulk-enrich --ids "id1,id2" --format csv

explorium businesses enrich-file

Match businesses from a file and enrich in one pass. Accepts CSV or JSON files with match parameters — no need to match first then bulk-enrich separately.

# From CSV file
explorium businesses enrich-file -f companies.csv

# From JSON file
explorium businesses enrich-file -f companies.json

# With lower confidence threshold
explorium businesses enrich-file -f companies.csv --min-confidence 0.6

# Show match statistics
explorium businesses enrich-file -f companies.csv --summary

# Override output format
explorium businesses enrich-file -f companies.csv --format csv

CSV file format (companies.csv):

name,domain
Salesforce,salesforce.com
HubSpot,hubspot.com
Zendesk,zendesk.com

JSON file format (companies.json):

[
  {"name": "Salesforce", "domain": "salesforce.com"},
  {"name": "HubSpot"},
  {"domain": "zendesk.com"}
]

Partial match failures are reported as warnings — successfully matched businesses are still enriched.

explorium businesses lookalike

Find similar companies.

Using ID:

# Find companies similar to Salesforce by ID
explorium businesses lookalike --id 39ae2ed11b14a4ccb41d35e9d1ba5d11

Using match parameters:

# Find companies similar to Salesforce (without knowing the ID)
explorium businesses lookalike --name "Salesforce"

# Find companies similar to Stripe
explorium businesses lookalike --domain "stripe.com"

# Find companies similar to Notion
explorium businesses lookalike --name "Notion" --domain "notion.so"

explorium businesses autocomplete

Get company name suggestions.

explorium businesses autocomplete --query "sales"

Business Events

# List events for Salesforce (event types required)
explorium businesses events list --ids "39ae2ed11b14a4ccb41d35e9d1ba5d11" --events "new_funding_round,new_product"

# Enroll Salesforce for event monitoring
explorium businesses events enroll --ids "39ae2ed11b14a4ccb41d35e9d1ba5d11" --events "new_funding_round" --key my-key

# List enrollments
explorium businesses events enrollments

Business event types: ipo_announcement, new_funding_round, new_investment, new_product, new_office, closing_office, new_partnership, increase_in_engineering_department, increase_in_sales_department, hiring_in_engineering_department, hiring_in_sales_department, and more.

Prospect Commands

explorium prospects match

Match prospects to get unique prospect IDs.

# Match by first/last name + company (most common)
explorium prospects match --first-name "Sally" --last-name "Massey" --company-name "Colgate-Palmolive"

# Match by LinkedIn URL (name is optional when linkedin/email is provided)
explorium prospects match --linkedin "https://www.linkedin.com/in/brigittaruha/"

# Match by email
explorium prospects match --email "brigitta.ruha@example.com"

# Batch match from JSON or CSV file (auto-batches if >50 rows)
explorium prospects match -f prospects.json
explorium prospects match -f prospects.csv

# Show match statistics
explorium prospects match -f prospects.csv --summary

# Output only matched IDs (one per line, pipeable)
explorium prospects match -f prospects.csv --ids-only

# Override output format for this command
explorium prospects match -f prospects.csv --format csv

Match file formats — use full_name + company_name for best results:

full_name,company_name
Satya Nadella,Microsoft
Marc Benioff,Salesforce
Tim Cook,Apple

Or with separate first/last name columns:

first_name,last_name,company_name
Satya,Nadella,Microsoft
Marc,Benioff,Salesforce

JSON format:

[
  {"full_name": "Satya Nadella", "company_name": "Microsoft"},
  {"full_name": "Marc Benioff", "company_name": "Salesforce"},
  {"linkedin": "https://linkedin.com/in/sundarpichai"}
]

Tip: When a strong identifier (linkedin or email) is present, full_name is optional. When using name-based matching, always include company_name — the API needs company context to disambiguate common names.

explorium prospects search

Search and filter prospects.

# Search within Colgate Palmolive
explorium prospects search --business-id "1006ff12c465532f8c574aeaa4461b16"

# Search executives at Colgate Palmolive
explorium prospects search --business-id 1006ff12c465532f8c574aeaa4461b16 --job-level "cxo,vp,director"

# Search by department at Salesforce
explorium prospects search --business-id 39ae2ed11b14a4ccb41d35e9d1ba5d11 --department "Engineering,Sales"

# Search with contact filters at Google
explorium prospects search --business-id c71497b026909c74b4ab3a4fbfcd122a --has-email --has-phone

# Combined filters with pagination
explorium prospects search --business-id 1006ff12c465532f8c574aeaa4461b16 --job-level cxo --page 1 --page-size 25

# Auto-paginate to collect a specific total
explorium prospects search --business-id 1006ff12c465532f8c574aeaa4461b16 --total 200

# Search from CSV file (with business_id column)
explorium prospects search -f business_ids.csv

explorium prospects enrich

Enrich prospect data. You can provide either a prospect ID directly, or use match parameters (name, linkedin, company) to automatically resolve the ID.

Using ID:

# Enrich contacts for Brigitta Ruha by ID (email, phone)
explorium prospects enrich contacts --id a0997d3905e02c919f1f7092ad4947c8e0cddade

# Enrich LinkedIn posts for Sally Massey by ID
explorium prospects enrich social --id 8112e31c5e3a4fc93d4413abeee778b5d4e5c99d

# Enrich professional profile by ID
explorium prospects enrich profile --id a0997d3905e02c919f1f7092ad4947c8e0cddade

Using match parameters (enrich without knowing the ID):

# Get contact info for Satya Nadella at Microsoft
explorium prospects enrich contacts --first-name "Satya" --last-name "Nadella" --company-name "Microsoft"

# Get contact info by LinkedIn URL
explorium prospects enrich contacts --linkedin "https://linkedin.com/in/satyanadella"

# Get LinkedIn posts for Marc Benioff
explorium prospects enrich social --first-name "Marc" --last-name "Benioff" --company-name "Salesforce"

# Get professional profile for Sundar Pichai
explorium prospects enrich profile --first-name "Sundar" --last-name "Pichai" --company-name "Google"

# With lower confidence threshold for less prominent prospects
explorium prospects enrich contacts --first-name "John" --last-name "Smith" --company-name "Acme Corp" --min-confidence 0.6

Available enrichment types:

Command Description
contacts Email addresses and phone numbers
social LinkedIn posts and activity
profile Full professional profile (experience, education, skills)

explorium prospects bulk-enrich

Bulk enrich multiple prospects with contact information (up to 50).

Using IDs:

# Bulk enrich by prospect IDs
explorium prospects bulk-enrich --ids "a0997d3905e02c919f1f7092ad4947c8e0cddade,8112e31c5e3a4fc93d4413abeee778b5d4e5c99d"

# From a CSV file (reads prospect_id column, ignores all other columns)
# This means match CSV output feeds directly into bulk-enrich:
explorium prospects match -f leads.csv -o csv --output-file matched.csv
explorium prospects bulk-enrich -f matched.csv --types all -o csv --output-file enriched.csv

Using match file (no IDs required):

Create a JSON file prospects_to_enrich.json:

[
  {"full_name": "Satya Nadella", "company_name": "Microsoft"},
  {"full_name": "Marc Benioff", "company_name": "Salesforce"},
  {"linkedin": "https://linkedin.com/in/sundarpichai"},
  {"full_name": "Tim Cook", "company_name": "Apple"}
]

Then run:

# Bulk enrich by resolving names/linkedin to IDs automatically
explorium prospects bulk-enrich --match-file prospects_to_enrich.json

# Choose enrichment type (contacts, profile, all)
explorium prospects bulk-enrich --ids "id1,id2" --types profile
explorium prospects bulk-enrich --match-file prospects_to_enrich.json --types all

# With lower confidence threshold
explorium prospects bulk-enrich --match-file prospects_to_enrich.json --min-confidence 0.6

# Show match/enrichment statistics
explorium prospects bulk-enrich --match-file prospects_to_enrich.json --summary

# Override output format
explorium prospects bulk-enrich --ids "id1,id2" --format csv

explorium prospects enrich-file

Match prospects from a file and enrich in one pass. Accepts CSV or JSON files with match parameters — no need to match first then bulk-enrich separately.

# From CSV file (default enrichment: contacts)
explorium prospects enrich-file -f prospects.csv

# From JSON file
explorium prospects enrich-file -f prospects.json

# Choose enrichment type (comma-separated: contacts, profile, all)
explorium prospects enrich-file -f prospects.csv --types profile
explorium prospects enrich-file -f prospects.csv --types all
explorium prospects enrich-file -f prospects.csv --types contacts,profile

# With lower confidence threshold
explorium prospects enrich-file -f prospects.csv --min-confidence 0.6

# Show match statistics
explorium prospects enrich-file -f prospects.csv --summary

# Override output format
explorium prospects enrich-file -f prospects.csv --format csv

CSV file format (prospects.csv):

first_name,last_name,company_name
Satya,Nadella,Microsoft
Marc,Benioff,Salesforce
Tim,Cook,Apple

JSON file format (prospects.json):

[
  {"full_name": "Satya Nadella", "company_name": "Microsoft"},
  {"full_name": "Marc Benioff", "company_name": "Salesforce"},
  {"linkedin": "https://linkedin.com/in/sundarpichai"}
]

Enrichment types (comma-separated):

--types Description
contacts Emails, phone numbers (default)
profile Professional profile, skills, experience
all Contacts + social + profiles combined
contacts,profile Run both contacts and profile enrichment

Partial match failures are reported as warnings — successfully matched prospects are still enriched.

explorium prospects autocomplete

Get prospect name suggestions.

explorium prospects autocomplete --query "john"

explorium prospects statistics

Get aggregated insights about prospects.

explorium prospects statistics \
  --business-id "1006ff12c465532f8c574aeaa4461b16" \
  --group-by "department,job_level"

Prospect Events

# List events for prospects (event types required)
explorium prospects events list --ids "a0997d3905e02c919f1f7092ad4947c8e0cddade" --events "prospect_changed_company"

# Enroll for job change monitoring
explorium prospects events enroll --ids "a0997d3905e02c919f1f7092ad4947c8e0cddade" --events "prospect_changed_company" --key my-key

# List enrollments
explorium prospects events enrollments

Prospect event types: prospect_changed_role, prospect_changed_company, prospect_job_start_anniversary

Webhook Commands

Note: Webhook commands require partner access. Contact Explorium for partner credentials.

# Create webhook
explorium webhooks create --partner-id YOUR_PARTNER_ID --url "https://example.com/webhook"

# Get webhook details
explorium webhooks get --partner-id YOUR_PARTNER_ID

# Update webhook
explorium webhooks update --partner-id YOUR_PARTNER_ID --url "https://new-url.com/webhook"

# Delete webhook
explorium webhooks delete --partner-id YOUR_PARTNER_ID

Output to File

Use --output-file to write clean data to a file instead of the terminal. File output contains no Rich formatting or ANSI codes.

# Write JSON to file
explorium --output-file results.json businesses search --country us

# Write CSV to file
explorium -o csv --output-file results.csv businesses search --country us

# Table format falls back to JSON when writing to file
explorium -o table --output-file results.json businesses search --country us

A confirmation message is printed to stderr: Output written to: results.json

Match Statistics

Use --summary on match, bulk-enrich, and enrich-file commands to print match statistics to stderr.

# Match with summary
explorium prospects match -f prospects.csv --summary
# Stderr: Matched: 77/88, Failed: 11

# Bulk enrich with summary
explorium businesses bulk-enrich --match-file companies.json --summary
# Stderr: Matched: 45/50, Failed: 5

# Enrich file with summary
explorium prospects enrich-file -f prospects.csv --summary
# Stderr: Matched: 23/25, Failed: 2

Output Formats

# JSON (default) - Enrich Salesforce
explorium businesses enrich --id 39ae2ed11b14a4ccb41d35e9d1ba5d11

# Table format
explorium -o table businesses search --country us

Configuration File

Default location: ~/.explorium/config.yaml

api_key: your-api-key-here
base_url: https://api.explorium.ai/v1

Use custom config:

explorium -c /path/to/config.yaml businesses search --country us

Quick Reference

Command Description
config set/show/clear Manage configuration
businesses match Match businesses to IDs
businesses search Search/filter businesses
businesses enrich Enrich with firmographics
businesses enrich-tech Enrich with technographics
businesses enrich-financial Enrich with financial metrics
businesses enrich-funding Enrich with funding/acquisitions
businesses enrich-workforce Enrich with workforce trends
businesses enrich-traffic Enrich with website traffic
businesses enrich-social Enrich with LinkedIn posts
businesses enrich-ratings Enrich with employee ratings
businesses enrich-keywords Search keywords on website
businesses enrich-challenges Business challenges (10-K)
businesses enrich-competitive Competitive landscape (10-K)
businesses enrich-strategic Strategic insights (10-K)
businesses enrich-website-changes Enrich with website changes
businesses enrich-webstack Enrich with webstack data
businesses enrich-hierarchy Enrich with company hierarchy
businesses enrich-intent Enrich with Bombora intent
businesses bulk-enrich Bulk enrich businesses
businesses enrich-file Match + enrich from CSV/JSON file
businesses lookalike Find similar companies
businesses autocomplete Company name suggestions
businesses events list/enroll/enrollments Event operations
prospects match Match prospects to IDs
prospects search Search/filter prospects
prospects enrich contacts/social/profile Enrich prospects
prospects bulk-enrich Bulk enrich prospects
prospects enrich-file Match + enrich from CSV/JSON file
prospects events list/enroll/enrollments Event operations
webhooks create/get/update/delete Webhook management (partner access)

Match-Based Enrichment

All enrichment commands support match-based enrichment - you can enrich without knowing the ID by providing match parameters.

Business Match Parameters

Option Description
--id Direct business ID (skips matching)
--name Company name for matching
--domain Company domain/website for matching
--linkedin LinkedIn company URL for matching
--min-confidence Minimum match confidence (0-1, default: 0.8)

Prospect Match Parameters

Option Description
--id Direct prospect ID (skips matching)
--first-name First name for matching
--last-name Last name for matching
--email Email address for matching
--linkedin LinkedIn profile URL for matching
--company-name Company name for matching
--min-confidence Minimum match confidence (0-1, default: 0.8)

Quick Examples

# Business enrichment without ID
explorium businesses enrich --name "Salesforce"
explorium businesses enrich-tech --domain "google.com"
explorium businesses lookalike --name "Stripe"

# Prospect enrichment without ID
explorium prospects enrich contacts --first-name "Satya" --last-name "Nadella" --company-name "Microsoft"
explorium prospects enrich profile --linkedin "https://linkedin.com/in/marcbenioff"

# Bulk enrichment with match file
explorium businesses bulk-enrich --match-file companies.json
explorium prospects bulk-enrich --match-file prospects.json

# One-pass file enrichment (match + enrich combined)
explorium businesses enrich-file -f companies.csv
explorium prospects enrich-file -f prospects.csv --types all

CSV Column Names

When using CSV files for match, enrich-file, or other file-based commands, column names are matched case-insensitively and support common aliases. If no recognized columns are found, the CLI shows an error listing expected column names.

Business CSV Columns

Canonical Name Also Accepted
name company_name, company, business_name
domain website, url, company_domain, company_website, site
linkedin_url linkedin, linkedin_company_url, company_linkedin

Prospect CSV Columns

Canonical Name Also Accepted
first_name firstname, first
last_name lastname, last, surname
full_name name, fullname, prospect_name
email email_address, e-mail, e_mail
linkedin linkedin_url, linkedin_profile
company_name company, employer, organization

Note: When matching prospects, full_name is automatically omitted from the API payload when a strong identifier (linkedin or email) is present but company_name is absent. The API cannot use a name without company context when a direct identifier is available.

Example: A CSV with columns Company,Website will work the same as name,domain.

If no recognized columns are found, you'll see an error like:

Error: No recognized business columns found in CSV.
Found columns: foo, bar, baz
Expected columns (or aliases):
  name (also: company_name, company, business_name)
  domain (also: website, url, company_domain, company_website, site)
  linkedin_url (also: linkedin, linkedin_company_url, company_linkedin)

ID Column Matching

When using CSV files with bulk-enrich (via --file), the prospect_id and business_id columns are also matched case-insensitively. So PROSPECT_ID, Prospect_Id, and prospect_id all work.

Pipeline: Match → Bulk-Enrich

The --ids-only and -o csv flags on match make it easy to pipe match results directly into bulk-enrich:

# Option 1: --ids-only outputs just IDs, one per line
explorium prospects match -f leads.csv --ids-only > prospect_ids.txt
explorium prospects bulk-enrich -f prospect_ids.txt

# Option 2: -o csv outputs a full CSV with prospect_id/business_id column.
# bulk-enrich reads that column and ignores everything else — no intermediate processing needed.
explorium businesses match -f companies.csv -o csv --output-file matched.csv
explorium businesses bulk-enrich -f matched.csv

explorium prospects match -f leads.csv -o csv --output-file matched.csv
explorium prospects bulk-enrich -f matched.csv --types all -o csv --output-file enriched.csv

Subcommand --format Option

The match, bulk-enrich, and enrich-file commands accept a --format option that overrides the global -o output format:

# Global output is JSON, but this specific command outputs CSV
explorium -o json prospects match --email "john@co.com" --format csv

# Available formats: json, table, csv
explorium businesses bulk-enrich --ids "id1,id2" --format table
explorium prospects enrich-file -f leads.csv --format csv