ZoomInfo CLI
ZoomInfo GTM CLI is a command-line client for accessing ZoomInfo's GTM data and AI capabilities from your terminal. Use a single gtm binary to search and enrich companies and contacts, retrieve intent, scoops, and news, run agentic research, and access your GTM context.
GTM CLI uses the same hosted backend as the ZoomInfo API and MCP server, with shared authentication, data access, and credits. Output results as JSON, JSONL, CSV, YAML, or a table.
Install ZoomInfo CLI
Homebrew is the shortest path on macOS and Linux.
brew install zoominfo/gtm-ai/gtm-ai-cliOn Windows, or anywhere you run Node, install the global NPM package instead.
npm install -g @zoominfo/gtm-ai-cliPrebuilt binaries for every platform are on the ZoomInfo GitHub page. Confirm the install.
gtm --versionAuthenticate
Sign-in is OAuth in your browser, with no client ID or secret to paste.
gtm auth login # opens your browser for signin
gtm auth whoami # show login status
gtm auth logout # revoke and remove saved credentialsThe token is written to ~/.config/gtm-ai at mode 0600.
Output Format
Every command that returns records accepts -f, --format: json (the default) and jsonl preserve the response shape, while csv, yaml, and table flatten it for reading.
gtm companies search --industry software -f table
gtm contacts search --management-level "C Level Exec" -f jsonl > c-level.jsonlAdd --select with a comma-separated list of dotted paths to keep only those fields from each record, applied before formatting.
gtm companies search --industry software --page-size 5 --select id,name,revenue -f tableCommand Glossary
This sections documents every GTM CLI command with copy-paste examples; the pattern repeats throughout, so search for IDs, enrich for detail, then pipe the rest through your shell.
lookup
Search endpoints reject unknown industry, metro, or topic strings with a 422, so look the canonical value up first and pass its ID to the filter.
gtm lookup --field industries --fuzzy software -f table
gtm lookup --field intent-topics --fuzzy cloud -f table
# Tech products take two steps: vendor first, then products
gtm lookup --field tech-vendors --fuzzy hubspot
gtm lookup --field tech-products --vendor "HubSpot, Inc"Companies
Search needs at least one filter; enrich accepts any identifier (ID, domain, name, ticker, or website); similar returns a machine-ranked list of look-alikes.
gtm companies search --industry software --metro "CA - San Francisco" --employees "100to249,250to499"
gtm companies search --type public --country "United States" --revenue-min 1000000 --sort -revenue -f table
gtm companies enrich --domain stripe.com --fields name revenue employeeCount industries
gtm companies similar --name "Stripe"
# Bulk enrich up to 10 companies from a JSON file
gtm companies enrich --file companies.jsonContacts
Search by role, seniority, company, or signal; enrich by person ID, email, phone, or name plus company; similar and recommended extend the set.
gtm contacts search --management-level "C Level Exec,VP Level Exec" --company-id 344589814
gtm contacts search --management-level Manager --department "Engineering & Technical" --required email,phone
gtm contacts enrich --email [[email protected]](mailto:[email protected]) --fields phone jobTitle managementLevel email
gtm contacts similar --person-id 1260398587 --company-id 239305146
gtm contacts recommended --company-id 344589814 --use-case PROSPECTINGIntent
Every intent request needs --topics (look the exact names up first), and filters then narrow which companies showing those signals come back.
gtm intent search --topics "Cloud Applications" "Java" --signal-score-min 70
gtm intent enrich --company-id 344589814 --topics "Cloud Applications"Scoops
Scoops capture funding, hiring, leadership moves, layoffs, launches, and other business events, searchable across the market or fetched for one known company.
gtm scoops search --scoop-types "New Hire" "Executive Move" --department C-Suite --published-start 2026-05-27
gtm scoops enrich --company-id 344589814 --scoop-types "New Hire" PromotionNews
News enrich returns categorized articles for a known company by ID, across categories like FUNDING, PRODUCT, PERSON, and MERGER_OR_ACQUISITION.
gtm news enrich --company-id 344589814 --categories FINANCIAL_RESULTS FUNDINGGTM-Context
GTM-Context get reads the offerings, ICPs, personas, and competitors that shape how every tool interprets your queries, and it costs zero credits.
gtm-context get
gtm-context get --detailed -f yaml
# Admins can update from text or a file
gtm-context update --query "Update competitors" --source "Our main competitors are X, Y, Z"Research
Research blends ZoomInfo market data with your CRM and conversation history into a brief, so frame the goal in --query and let the tool choose what to retrieve.
gtm research account --company-id 344589814 --query "Prep for a renewal call: status, news, and risks"
gtm research contact --contact-id 1260398587 --query "Who is this person and our history before I reach out"Raw
When a tool has no dedicated wrapper yet, raw lists the catalog and calls any tool by name.
gtm raw list-tools -f table
gtm raw call find_similar_companies --args '{"companyName":"Stripe"}'Updated 2 days ago