Skip to content
User Guide
Integrations
CLI

CLI

Overview

The Evident CLI provides a command-line tool for bulk IP enrichment from a CSV file. It’s a drop-in alternative to the UI upload for teams that prefer scripted workflows, scheduled jobs, or integration with existing data pipelines.

Installation

The CLI is distributed as a Python package. Install it with pip:

pip install evident

This registers the ip-identify command in your environment.

Authenticate

The CLI uses the same API key as the REST API. Set it as an environment variable:

export EVIDENT_API_KEY=your-api-key

API keys are generated in Settings → API in the Evident dashboard.

Basic usage 

ip-identify --input path/to/ips.csv --output path/to/results.csv

The input file must contain an ip_address column. All other columns are passed through unchanged in the output.

Options

Option Default Description
--input — Path to the input CSV file (required)
--output — Path to write the enriched output CSV (required)
--workers 32 Number of parallel worker threads for enrichment
--batch-size 1000 Number of IPs to submit per batch request
--amplitude-start — Start datetime for Amplitude event import (ISO 8601)
--amplitude-end — End datetime for Amplitude event import (ISO 8601)

Output columns

The output file contains all original input columns plus the Evident enrichment fields. See Data → Download processed results for the full column reference.

Amplitude import via CLI

The --amplitude-start and --amplitude-end options let you trigger an Amplitude event import directly from the command line, bypassing the UI wizard:

ip-identify \
  --amplitude-start 2026-03-28T00:00:00 \
  --amplitude-end 2026-03-28T23:59:59 \
  --output results.csv

This is useful for scheduled jobs (cron, Airflow, etc.) or one-off historical backfills.

Performance

With the default --workers 32 setting, the CLI processes large CSV files efficiently in parallel. For very large files, you can increase --workers up to the rate limit of your plan, or reduce --batch-size if you’re hitting memory constraints.

Quota

CLI enrichment counts toward the same monthly tracked accounts limit as API and UI jobs. Accounts already identified earlier in the same billing month are not counted again.

Need help?

Contact support@useevident.com with your CLI version (ip-identify --version) and any error output if you’re running into issues.

REST APIHubSpot