--- updatedAt: 2026-07-24T05:38:38.000Z agentTools: projectIndex: https://docs.gtm.ai/llms.txt --- # 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. ```text Terminal brew install zoominfo/gtm-ai/gtm-ai-cli ``` On Windows, or anywhere you run Node, install the global NPM package instead. ```text Terminal npm install -g @zoominfo/gtm-ai-cli ``` Prebuilt binaries for every platform are on the ZoomInfo GitHub page. Confirm the install. ```text Terminal gtm --version ``` *** ## Authenticate Sign-in is OAuth in your browser, with no client ID or secret to paste. ```text Terminal gtm auth login # opens your browser for signin gtm auth whoami # show login status gtm auth logout # revoke and remove saved credentials ``` The 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. ```text Terminal gtm companies search --industry software -f table gtm contacts search --management-level "C Level Exec" -f jsonl > c-level.jsonl ``` Add --select with a comma-separated list of dotted paths to keep only those fields from each record, applied before formatting. ```text Terminal gtm companies search --industry software --page-size 5 --select id,name,revenue -f table ``` ## Command 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. ```powershell Terminal 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. ```powershell Terminal 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.json ``` ### Contacts Search by role, seniority, company, or signal; enrich by person ID, email, phone, or name plus company; similar and recommended extend the set. ```powershell Terminal 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 [henry@zoominfo.com](mailto:henry@zoominfo.com) --fields phone jobTitle managementLevel email gtm contacts similar --person-id 1260398587 --company-id 239305146 gtm contacts recommended --company-id 344589814 --use-case PROSPECTING ``` ### Intent Every intent request needs --topics (look the exact names up first), and filters then narrow which companies showing those signals come back. ```powershell Terminal 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. ```powershell Terminal 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" Promotion ``` ### News News enrich returns categorized articles for a known company by ID, across categories like FUNDING, PRODUCT, PERSON, and MERGER\_OR\_ACQUISITION. ```powershell Terminal gtm news enrich --company-id 344589814 --categories FINANCIAL_RESULTS FUNDING ``` ### GTM-Context GTM-Context get reads the offerings, ICPs, personas, and competitors that shape how every tool interprets your queries, and it costs zero credits. ```powershell Terminal 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. ```powershell Terminal 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. ```powershell Terminal gtm raw list-tools -f table gtm raw call find_similar_companies --args '{"companyName":"Stripe"}' ```