Topify CLI

Monitor your brand's AI visibility from the command line.

Install

npm install -g @topify/cli

Setup

# Set your API key (get it at https://app.topify.ai → Settings → API Keys)
topify config --api-key tk_live_xxxxxxxxxxxxx

# Set a default project
topify projects                              # list all projects
topify config --default-project <project-id> # set default

Commands

# Projects
topify projects              # list all projects

# Overview — visibility summary across all prompts
topify overview              # last 7 days
topify overview --days 30    # last 30 days
topify overview --from 2026-03-01 --to 2026-03-15

# Competitors — ranked by visibility
topify competitors
topify competitors --days 30

# Prompts — tracked search queries
topify prompts

# Sources — domains cited in AI responses
topify sources
topify sources --days 30

# Topics — prompt groupings
topify topics

# Trends — visibility over time
topify trends --days 30 --json

Options

All data commands support:

• -p, --project <id> — specify project (or use default)
• -d, --days <n> — lookback period (default: 7)
• --from <date> / --to <date> — date range (YYYY-MM-DD)
• --providers <list> — filter by provider (chatgpt, perplexity, google_ai_overview)
• --json — output raw JSON

Environment Variable

You can also set your API key via environment variable:

export TOPIFY_API_KEY=tk_live_xxxxxxxxxxxxx

Use with Claude Code

Add to your project's CLAUDE.md:

## Topify AI Visibility
Run `topify` commands to check brand visibility in AI search.
API key is configured via `topify config`.

Then ask Claude: "Show my brand visibility for the last 30 days"

API Documentation

https://docs.topify.ai/api-reference/public/introduction