Cornect CLI

Cornect from your terminal.

Search companies, manage exports, and check credits from the command line — with scriptable JSON and CSV output, so it drops straight into your pipelines and CI.

Install the CLI View API docs

cornect — zsh

$ cornect search --query fintech --country "Germany" --limit 5

NAME            DOMAIN            COUNTRY   INDUSTRY     EMPLOYEES
──────────────  ────────────────  ────────  ───────────  ─────────
Solaris SE      solarisgroup.com  Germany   Fintech      720
Mambu           mambu.com         Germany   Software     1000
Raisin          raisin.com        Germany   Fintech      650

Showing 3 of 128. Next page: --cursor eyJvZmZzZXQiOjN9

$ cornect credits
Balance: 1,250 credits

What you can do

The whole API, one command away.

cornect search

Search the company database with filters — query, country, industry, exclude lists, tech, size. Table, --json, or --csv output.

cornect company get

Fetch a single company's full detail by id — profile, location, tech stack, funding.

cornect export

Create export jobs, poll their status, and download the CSV — straight to a file.

cornect credits

Check your workspace credit balance and recent transactions before bulk operations.

cornect login

Authenticate once — your token is stored securely (chmod 600), or set CORNECT_API_TOKEN for CI.

--json / --csv

Every command speaks JSON and CSV for pipelines — pipe to jq, redirect to a file, wire into scripts.

Install

Up and running in a minute.

Get an API token

Create a token at Account → API tokens. Choose read for search and lookup, or read_write if you'll create exports.

Get an API token

Install the CLI

Install globally, or run on demand with npx:

install

npm install -g @cornect/cli
# or, without installing:
npx @cornect/cli <command>

ℹThe npm package isn't published yet — until it is, install from source: clone the repo and run the cli README (npm install && npm run build && npm link).

Authenticate

authenticate

cornect login
# CI/scripts:
export CORNECT_API_TOKEN=cornect_your_token

Use it

Filter with full country names ("Germany", not "DE"). Pipe JSON to jq or CSV to a file:

examples

$ cornect search --query saas --country "United States"
$ cornect search --query fintech --json | jq '.items[].domain'
$ cornect search --country "Germany" --csv > german-companies.csv

Built for scripting

Tables for you, JSON for your scripts.

Every command prints a clean table by default, and switches to --json or --csv for pipelines. Colors turn off automatically when output is piped, so redirected data stays clean. Set CORNECT_API_TOKEN and it runs unattended in CI.

FAQ

Questions, answered.

Is it free?

Yes — the CLI is free. You only spend Cornect credits when creating exports. Search, company lookup, credit checks, and export status/downloads don't charge.

Which token scope do I need?

A read token covers search, company lookup, and credits. Use a read_write token only if you'll create exports (cornect export create).

How do I filter by country?

Use full country NAMES, not ISO codes — "Germany", "United States", "United Kingdom" (not "DE"/"US"). ISO codes match nothing. The same applies to industries. To target a city, also pass --country (city names repeat across countries).

Where's the source / help?

The CLI lives in the Cornect repo under cli/. Until it's published to npm, install it from source — see the README in the repo. Questions: saadi@cornect.io.

Get started.

Get an API token Read the docs