---
title: "CLI"
slug: "cli"
updated: 2026-05-26T10:49:47Z
published: 2026-05-26T10:49:47Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

The Supermetrics CLI is a command-line tool for querying marketing data, managing OAuth login links, triggering Data Warehouse backfills, and more — directly from your terminal or scripts. It wraps the Supermetrics API and is available for macOS, Linux, and Windows.

> **Alpha release** — The CLI is under active development. Features, flags, and behavior may change without notice.

## What you can do with the CLI

- Query data from hundreds of marketing and analytics sources
- Export results as JSON, CSV, or a formatted table
- Manage OAuth login links for data source authentication
- Trigger and monitor Data Warehouse backfills
- Build and manage custom connectors via Connector Builder
- Automate reporting in bash scripts, cron jobs, and CI/CD pipelines

## Getting started

See the [**CLI README**](https://github.com/supermetrics-public/supermetrics-cli/blob/main/README.md) for installation instructions, authentication setup, a full command reference, and configuration options.

## Examples

See the [**Examples Guide**](https://github.com/supermetrics-public/supermetrics-cli/blob/main/docs/examples.md) for 50+ copy-paste-ready commands across Google Ads, Facebook Ads, GA4, Shopify, Salesforce, and 200+ other platforms.

## Issues and feedback

The CLI is open source. To report a bug or request a feature, open an issue on the [GitHub repository](https://github.com/supermetrics-public/supermetrics-cli/issues).