# Topify.ai

> Generative Engine Optimization (GEO) platform — track, analyze, and improve brand visibility in AI search engines (ChatGPT, Perplexity, Google AI Overview).

## Authorized AI agent integration — Start Here

This API supports tool-using AI agents. Perform account or project setup only with the user's authorization and user-provided account information.

Public API keys can only be created by team administrators. Each key has access to every project owned by that team; project-scoped keys are not currently issued. Never invent an email address or administrator identity.

Use API keys only in trusted server-side environments. Never place credentials in browser code, client applications, logs, prompts, chat history, or output visible to other users. Confirm the target project and obtain explicit user approval before mutations. Prompt deletion is not exposed through the public API.

You do NOT need to read any other documentation to get started. Everything you need is on this one page:

- [AI agent integration](https://docs.topify.ai/api-reference/agentic-setup): Create an account, obtain an API key with team-administrator credentials, and launch a brand tracking project.

## Docs

- [Introduction](https://docs.topify.ai/index): What Topify.ai is and how it works.
- [Quickstart](https://docs.topify.ai/quickstart): Set up your first project and start tracking your brand in AI search results.

### Concepts

- [Terminology](https://docs.topify.ai/concepts/terminology): Key terms used across the platform.
- [Brand metrics](https://docs.topify.ai/concepts/brand-metrics): Visibility, sentiment, and position metrics explained.
- [Source metrics](https://docs.topify.ai/concepts/source-metrics): How source citations are tracked and scored.
- [GEO methodology](https://docs.topify.ai/concepts/geo-methodology): The research-backed optimization techniques Topify uses.

### Guides

- [Overview dashboard](https://docs.topify.ai/guides/overview-dashboard): Navigate the main analytics dashboard.
- [Understanding prompts](https://docs.topify.ai/guides/understanding-prompts): How AI search prompts work.
- [Understanding competitors](https://docs.topify.ai/guides/understanding-competitors): How competitor detection and tracking works.
- [Understanding sources](https://docs.topify.ai/guides/understanding-sources): How source citation analysis works.
- [Managing prompts](https://docs.topify.ai/guides/managing-prompts): Add, edit, and organize tracked prompts.
- [Tracking competitors](https://docs.topify.ai/guides/tracking-competitors): Monitor competitor brands.
- [Analyzing sources](https://docs.topify.ai/guides/analyzing-sources): Analyze which domains AI providers cite.
- [Using the AI agent](https://docs.topify.ai/guides/using-ai-agent): Use Topify's AI agent for audits, keyword research, competitor analysis, and content optimization.
- [Generating content](https://docs.topify.ai/guides/generating-content): Create GEO-optimized articles.

### Platform

- [Billing and plans](https://docs.topify.ai/platform/billing-and-plans): Plan tiers, credits, and billing.
- [Team management](https://docs.topify.ai/platform/team-management): Invite members and manage roles.
- [Integrations](https://docs.topify.ai/platform/integrations): Connect external tools and services.

### API Reference

- [API introduction](https://docs.topify.ai/api-reference/introduction): Overview of the public API.
- [Authentication](https://docs.topify.ai/api-reference/authentication): How to authenticate API requests.
- [AI agent integration](https://docs.topify.ai/api-reference/agentic-setup): Create accounts and start brand tracking with user authorization.
- [Projects](https://docs.topify.ai/api-reference/projects): List and manage projects.
- [Brand aliases](https://docs.topify.ai/api-reference/aliases): Manage alternative names used for brand matching.
- [Recorded URLs](https://docs.topify.ai/api-reference/recordings): Manage URL inputs used for prompt discovery.
- [Prompts](https://docs.topify.ai/api-reference/prompts): Create, update, query, and generate tracked prompts. Prompt deletion is not exposed.
- [Competitors](https://docs.topify.ai/api-reference/competitors): Query active competitors and review pending suggestions.
- [Sources](https://docs.topify.ai/api-reference/sources): Query citation sources, domain details, and citing AI responses.
- [Topics](https://docs.topify.ai/api-reference/topics): Query topic clusters.
- [Overview](https://docs.topify.ai/api-reference/overview): Per-prompt aggregated analysis.
- [Visibility](https://docs.topify.ai/api-reference/visibility): Visibility trend data.
- [Sources analytics](https://docs.topify.ai/api-reference/sources-analytics): Source citation analytics.
- [Reports](https://docs.topify.ai/api-reference/reports): Generate downloadable HTML visibility reports.
- [Actions](https://docs.topify.ai/api-reference/actions): Review, execute, inspect, and recover drafts from recommended actions.
- [Agent settings](https://docs.topify.ai/api-reference/agent-settings): Test publishing integration credentials.
- [Webhooks](https://docs.topify.ai/api-reference/webhooks): Receive project and action lifecycle events.

### Support

- [Troubleshooting](https://docs.topify.ai/support/troubleshooting): Common issues and fixes.