# Writesonic Docs

> Writesonic is the GEO platform that tracks your AI visibility across ChatGPT, Gemini, Claude, and 10+ AI search platforms. Diagnose gaps. Own the answer.

## Docs

- [Overview](https://apidocs.writesonic.com/docs/geo-getting-started.md): AI search engines like ChatGPT, Google AI Overviews, and Bing Copilot are changing how people search. Instead of browsing links, users now get direct, AI-generated answers. That means your brand’s visibility depends less on traditional rankings and more on whether you’re cited or mentioned inside th…
- [Overview](https://apidocs.writesonic.com/docs/ai-traffic-analytics.md)
- [Setup and Implementation Guide](https://apidocs.writesonic.com/docs/ai-traffic-analytics-setup-and-implementation-guide.md): AI Traffic Analytics is a server-side analytics solution that captures and analyzes raw traffic directly from your infrastructure logs—not the browser. This guide walks you through the process of implementing AI Traffic Analytics on your website.
- [Integrating With Cloudflare](https://apidocs.writesonic.com/docs/integrating-with-cloudflare.md)
- [Integrating with Wordpress](https://apidocs.writesonic.com/docs/integrating-with-wordpress.md): This guide walks you through the process of implementing AI Traffic Analytics on your Wordpress website.
- [Integrating with Vercel Log Drains](https://apidocs.writesonic.com/docs/integrating-with-vercel-log-drains.md): This doc will guide you how to Integrate the AI Traffic Analytics using Vercel. It uses Vercel's log drain feature and can only be availed by users on Vercel Pro/Enterprise plan
- [Integrating with Drupal](https://apidocs.writesonic.com/docs/integrating-with-drupal.md): This guide walks you through the process of implementing AI Bot Analytics on your Drupal website using the Writesonic AI Analytics module.
- [Integrating With Fastly Log Streaming](https://apidocs.writesonic.com/docs/integrating-with-fastly-log-streaming.md): This guide walks you through the process of implementing AI Bot Analytics on your website using Fastly's realtime log streaming.
- [Integrating with Custom Log Drain](https://apidocs.writesonic.com/docs/integrating-with-custom-log-drain.md): This guide walks you through the process of implementing AI Bot Analytics using a custom integration. This method allows you to integrate with any platform or custom application by making direct HTTP requests to Writesonic's analytics endpoint.
- [Integrating with Cloudfront](https://apidocs.writesonic.com/docs/integrating-with-cloudfront.md): This guide walks you through the process of implementing AI Bot Analytics on your Cloudfront website using AWS CloudFormation stack.
- [Understanding Your Dashboard](https://apidocs.writesonic.com/docs/ai-traffic-analytics-understanding-your-dashboard.md): Your AI Traffic Analytics dashboard provides a comprehensive view of how AI crawlers interact with your website. Here's how to interpret the data and gain actionable insights.
- [Optimizing for AI Visibility](https://apidocs.writesonic.com/docs/ai-traffic-analytics-optimizing-for-ai-visibility.md)
- [Troubleshooting and FAQs](https://apidocs.writesonic.com/docs/ai-traffic-analytics-troubleshooting-and-faqs.md)
- [AI Search Basics: What It Is & How It Works](https://apidocs.writesonic.com/docs/ai-search-visibility.md)
- [AI Search Vocabulary & Metrics [Very Important]](https://apidocs.writesonic.com/docs/ai-search-vocabulary-concepts-very-important.md): Let's understand what we're actually looking at when we track AI search.
- [Prompts vs Keywords [Very Important]](https://apidocs.writesonic.com/docs/prompts-vs-keywords-very-important.md): The way people search has fundamentally changed. What worked for Google doesn't work for AI search.
- [Platform Behavior & Volatility](https://apidocs.writesonic.com/docs/platform-behavior-tracking.md): Ever wonder why ChatGPT recommends your brand while Claude doesn't? Or why your visibility is 60% on Perplexity but only 40% on Google AI? There's a method to this madness.
- [Why We Monitor Real AI Platforms, Not Just APIs](https://apidocs.writesonic.com/docs/why-we-monitor-real-ai-platforms-not-just-apis.md)
- [Dashboard](https://apidocs.writesonic.com/docs/dashboard.md)
- [Getting Started: Onboarding and Configuring Your Brand](https://apidocs.writesonic.com/docs/getting-started-onboarding-and-configuring-your-brand.md)
- [Set your target topics](https://apidocs.writesonic.com/docs/set-you-target-topics.md)
- [Review and modify prompts](https://apidocs.writesonic.com/docs/review-and-modify-prompts.md)
- [Select competitors](https://apidocs.writesonic.com/docs/select-competitors.md)
- [Overview](https://apidocs.writesonic.com/docs/overview-page.md)
- [Overview: Competitors](https://apidocs.writesonic.com/docs/overview-page-competitors-tab-copy.md): The  on the Overview page gives you a clear picture of how your brand stacks up against the competition in AI-generated responses. It surfaces the key players in your space, tracks their performance over time, and helps you identify exactly where you're winning — and where you're falling behind.
- [Overview: Platforms](https://apidocs.writesonic.com/docs/overview-platforms.md): The  tab within the Overview page gives you a detailed breakdown of how your brand performs across individual AI search platforms. While the General tab shows your overall AI visibility, the Platforms view lets you compare performance across engines like , and others — so you can see exactly where y…
- [Overview](https://apidocs.writesonic.com/docs/sentiment-overview.md): The  page is your central hub for understanding how AI search engines perceive and talk about your brand. It aggregates sentiment data from AI-generated responses across platforms like ChatGPT, Perplexity, Claude, Google AI Overviews, and others — giving you a clear picture of whether your brand is…
- [Sentiment: Themes and Keywords](https://apidocs.writesonic.com/docs/all-themes.md): The  page gives you a fast, at-a-glance view of  — and whether that conversation is positive or negative.
- [Sentiment: Platforms](https://apidocs.writesonic.com/docs/sentiment-platform.md)
- [Sentiment: Competitors](https://apidocs.writesonic.com/docs/sentiment-competitors.md)
- [Overview](https://apidocs.writesonic.com/docs/prompts-overview.md): The  page is your central hub for understanding how your brand performs across AI-generated search results. It aggregates data from major AI platforms — including ChatGPT, Perplexity, Claude, Google AI Overviews, and more — into a single, actionable dashboard.
- [All Prompts and Answers](https://apidocs.writesonic.com/docs/all-prompts.md): The  page is your single, unified view of every prompt GEO is tracking — and every AI-generated answer those prompts produce. It combines two complementary tabs —  and  — so you can move seamlessly from "what are we tracking?" to "what did the AI actually say?"
- [Missing Prompts](https://apidocs.writesonic.com/docs/missing-prompts.md): What it is: A dashboard in GEO (Generative Engine Optimization) that shows queries where . These are your missed AI visibility opportunities.
- [Overview](https://apidocs.writesonic.com/docs/citations-overview-page.md): The Citations Overview page is your command center for understanding how AI search engines reference and link back to your content. It brings together everything you need — citation volume, source authority, competitive gaps, and content performance — in a single, actionable view.
- [All Citations](https://apidocs.writesonic.com/docs/all-citations.md): The  page lists every webpage that generative‑AI systems (ChatGPT, Google SGE, Bing Chat, etc.) cite when answering questions in your niche. It tells you:
- [Citations: Domains Mentioning me(User's Brand)](https://apidocs.writesonic.com/docs/citations-domains-mentioning-you-brand.md)
- [Citations: Your Content Performance](https://apidocs.writesonic.com/docs/citations-content-performance.md): Track how your website pages perform when cited by AI — and see exactly where you stand against competitors.
- [Citation Opportunities](https://apidocs.writesonic.com/docs/citation-opportunity.md): The  page shows you where competitors are getting cited in AI-generated answers — but your brand isn't. Think of these as gaps in your AI visibility that you can close through outreach, content improvements, or PR efforts.
- [Action Center: Actionables](https://apidocs.writesonic.com/docs/action-center-actionables.md): The Action Center is your strategic command hub for maximizing brand visibility across AI-powered search engines including ChatGPT, Claude, Google AI Overviews, Perplexity, and Gemini. Let’s get you started with your first optimization in under 5 minutes.
- [Content Optimization](https://apidocs.writesonic.com/docs/content-optimization.md)
- [Prompt Explorer](https://apidocs.writesonic.com/docs/prompt-explorer.md)
- [Portfolio](https://apidocs.writesonic.com/docs/portfolio.md): The  feature in Page Tracker allows you to group and monitor multiple pages as a single unit. Instead of tracking pages individually, you can organize them into meaningful collections—such as blog posts, product pages, or competitor content—and measure their collective impact on your AI visibility.
- [Markets: Track multiple Regions and Languages](https://apidocs.writesonic.com/docs/markets-track-multiple-regions-and-languages.md)
- [Tags](https://apidocs.writesonic.com/docs/tags.md)
- [Writesonic GEO Looker Studio Integration](https://apidocs.writesonic.com/docs/writesonic-geo-looker-studio-integration.md): Connect your AI search visibility data to Google Looker Studio
- [What is Writesonic Agents](https://apidocs.writesonic.com/agents/overview.md): Agents is the half of Writesonic that does the work. Specialist agents read your SEO, content and AI search data, find what to fix, and fix it with your approval.
- [Connect your data](https://apidocs.writesonic.com/agents/connect-your-data.md): Google Search Console is required. Add an analytics source and your CMS from there. The first connection takes about ten minutes.
- [Run your first task](https://apidocs.writesonic.com/agents/run-your-first-task.md): Create one task, watch an agent work it, and review what comes back. About fifteen minutes from here to a finished draft.
- [What to expect](https://apidocs.writesonic.com/agents/what-to-expect.md): What works on day one, what needs a few days of data, and why Pages looks empty at first.
- [Your first week](https://apidocs.writesonic.com/agents/your-first-week.md): A sequenced plan: what to do on day one, what to check on day three, and what to turn into a playbook by Friday.
- [How Writesonic Agents works](https://apidocs.writesonic.com/agents/how-it-works.md): Integrations, the Brand Kit, the agents, tasks, pages and playbooks. This page shows how they fit together.
- [Where context lives](https://apidocs.writesonic.com/agents/where-context-lives.md): Brand Kit, content types, Knowledge Base or the task description. A decision table for where a piece of context belongs.
- [Brand Kit](https://apidocs.writesonic.com/agents/set-up-brand-kit.md): Brand Kit gives every agent the same standing business, audience, voice, content, and design context on every task.
- [Business and objectives](https://apidocs.writesonic.com/agents/brand-kit-business.md): The facts that anchor every task, and the goals the work is measured against.
- [Audiences and voices](https://apidocs.writesonic.com/agents/brand-kit-audiences-voices.md): Who a piece is written for, and which of your voices it's written in.
- [Authors](https://apidocs.writesonic.com/agents/brand-kit-authors.md): Define who can appear in a byline, what supports their authority, and what they're allowed to say.
- [Content types](https://apidocs.writesonic.com/agents/brand-kit-content-types.md): The format rules for each thing you publish: length, structure, formatting and real examples.
- [Design](https://apidocs.writesonic.com/agents/brand-kit-design.md): Design is the Brand Kit section that stores your visual language for the Design agent.
- [Knowledge Base](https://apidocs.writesonic.com/agents/knowledge-base.md): Keep the source material agents use accurate, organized, and current.
- [The agent team](https://apidocs.writesonic.com/agents/the-agent-team.md): Meet the specialist agents for Research, SEO/GEO, Content, and Design, coordinated by a CMO agent.
- [Choosing an agent](https://apidocs.writesonic.com/agents/choosing-an-agent.md): One artifact goes to a specialist. A list, or anything needing research first, goes to the CMO.
- [Tasks](https://apidocs.writesonic.com/agents/tasks.md): A task is one unit of work you hand to an agent. This page covers the full lifecycle, subtasks, blocking, and why done is a human action.
- [Approvals and review](https://apidocs.writesonic.com/agents/approvals.md): Three review modes control how much you check before work is applied. Nothing reaches your live site without a person approving it.
- [Writing good tasks](https://apidocs.writesonic.com/agents/writing-good-tasks.md): Give a goal, not a procedure. The agent already knows your brand, so spend the description on what's specific to this job.
- [Tag context into a task](https://apidocs.writesonic.com/agents/tagging-context.md): Point a task at a specific playbook, author, audience or source instead of describing it in prose and hoping the agent picks the right one.
- [Common tasks](https://apidocs.writesonic.com/agents/common-tasks.md): Templates for the tasks teams hand over most. Copy one, swap in your page or topic, and send it.
- [Pages](https://apidocs.writesonic.com/agents/pages.md): See search, traffic, and AI visibility signals for each URL, then narrow the table to the pages that need work.
- [Page detail](https://apidocs.writesonic.com/agents/page-detail.md): Inspect one page across five evidence tabs, then turn its named opportunities into a reviewed agent task.
- [Activity log](https://apidocs.writesonic.com/agents/activity-log.md): Every change to a page, and every signal that followed it, on one timeline. Correlation you can read, not attribution you have to trust.
- [Playbooks](https://apidocs.writesonic.com/agents/playbooks.md): A workflow written down once, then run on demand. Playbooks are what a repeated task should become.
- [Playbook library](https://apidocs.writesonic.com/agents/playbook-library.md): The playbooks that ship with Agents, what each one does, and which are still in beta.
- [Build a playbook](https://apidocs.writesonic.com/agents/build-a-playbook.md): Describe the workflow and it gets built as a step graph. Then open the editor, fix what's wrong, test it, and publish.
- [Import your existing skills](https://apidocs.writesonic.com/agents/import-skills.md): Bring the Agent Skills and MCP servers your team already runs into your workspace without rebuilding them.
- [Grids](https://apidocs.writesonic.com/agents/grids.md): A spreadsheet where every row runs the same playbook. Import your list, run it, and review row by row.
- [Integrations](https://apidocs.writesonic.com/agents/integrations.md): Every app you can connect, whether it's required, and what each one feeds.
- [Publishing](https://apidocs.writesonic.com/agents/publishing.md): Finished work lands in your CMS as a draft. Publishing stays a human action.
- [Security and data](https://apidocs.writesonic.com/agents/security-and-data.md): What Agents can access, what it can change, where your data goes, and what it is never used for.
- [Glossary](https://apidocs.writesonic.com/agents/glossary.md): Every term the Agents docs use, defined once.
- [Troubleshooting](https://apidocs.writesonic.com/agents/troubleshooting.md): The things that actually go wrong, and what to do about each one.
- [Authentication](https://apidocs.writesonic.com/api-reference/authentication.md): How to authenticate with the Writesonic GEO API using your API key.
- [Get All Projects](https://apidocs.writesonic.com/api-reference/generic/get-all-projects.md): Get all projects that have geo presence tracking enabled. ALWAYS call this first — every other tool needs a `project_id`, and this is the only place to get one.
- [Get All Prompts](https://apidocs.writesonic.com/api-reference/generic/get-all-prompts.md): List all tracked prompts/queries in your project.
- [Get All Topics](https://apidocs.writesonic.com/api-reference/generic/get-all-topics.md): List all topics (categories that group prompts).
- [Get Tags](https://apidocs.writesonic.com/api-reference/generic/get-tags.md): List all tags (custom labels attached to prompts).
- [Get All Citations](https://apidocs.writesonic.com/api-reference/generic/get-all-citations.md): List individual citation records (URL, domain, title) found in AI responses.
- [Get Websites](https://apidocs.writesonic.com/api-reference/generic/get-websites.md): Compare your brand against competitors with per-website performance metrics.
- [Get Keywords](https://apidocs.writesonic.com/api-reference/generic/get-keywords.md): Browse keywords that AI models associate with your brand, organized by theme and subtheme.
- [Get AI Models](https://apidocs.writesonic.com/api-reference/generic/get-ai-models.md): Get the list of tracked AI models/platforms (metadata only, no performance metrics).
- [Get Markets](https://apidocs.writesonic.com/api-reference/generic/get-markets.md): Browse all geographic markets and their tracking coverage.
- [Get Domain Reports](https://apidocs.writesonic.com/api-reference/generic/get-domain-reports.md): Browse all external domains that appear in AI response citations.
- [Get Performance Report](https://apidocs.writesonic.com/api-reference/reports/get-performance-report.md): Brand performance metrics grouped by one or more dimensions.
- [Get Citation Report](https://apidocs.writesonic.com/api-reference/reports/get-citation-report.md): Citation metrics grouped by one or more dimensions.
- [Get Sentiment Report](https://apidocs.writesonic.com/api-reference/reports/get-sentiment-report.md): Keyword sentiment metrics grouped by one or more dimensions.
- [MCP Server](https://apidocs.writesonic.com/mcp/mcp-server.md): Connect Writesonic's AI search visibility data directly to Claude and other MCP-compatible AI assistants.
- [Setup Guide](https://apidocs.writesonic.com/mcp/setup.md): Step-by-step instructions for connecting the Writesonic MCP server to your AI assistant.
- [Tools Reference](https://apidocs.writesonic.com/mcp/tools-reference.md): Complete reference for all 87 tools available in the Writesonic MCP server.
- [Use Cases & Examples](https://apidocs.writesonic.com/mcp/examples.md): Real-world prompts and workflows for the Writesonic MCP server.
- [Authentication](https://apidocs.writesonic.com/api-reference/agents/authentication.md): Programmatic access to Writesonic Agents: projects, tasks, playbooks, grids, knowledge base, and pages, over a simple API-key-authenticated REST API.
- [Get caller identity and projects](https://apidocs.writesonic.com/api-reference/business/get-caller-identity-and-projects.md): Tells you who is calling: their identity, the HQ teams they belong to, and the projects in the workspace they are currently in.
- [List project resources](https://apidocs.writesonic.com/api-reference/business/list-project-resources.md): Looks up the reference things that belong to a project, such as its people, labels, settings, skills, and agents.
- [Create a task](https://apidocs.writesonic.com/api-reference/business/create-a-task.md): Add a brand-new task to the project. This only ever adds: it never overwrites existing data, and the new task shows up in the product like any other.
- [Query tasks](https://apidocs.writesonic.com/api-reference/business/query-tasks.md): Search and list the project's tasks, or get grouped totals across them.
- [Get task detail](https://apidocs.writesonic.com/api-reference/business/get-task-detail.md): Get everything about one task, always including its attachments and labels, and optionally its activity timeline, its links to other tasks, and any pending approvals.
- [Update a task](https://apidocs.writesonic.com/api-reference/business/update-a-task.md): Change an existing task: edit its fields, move it to a different status, or assign it to someone. Every change here is reversible.
- [Comment on a task](https://apidocs.writesonic.com/api-reference/business/comment-on-a-task.md): Add a comment to a task's discussion.
- [Query agent runs](https://apidocs.writesonic.com/api-reference/business/query-agent-runs.md): See the history of agent runs for a task or an agent, or follow the step-by-step progress of a single run.
- [List workflows](https://apidocs.writesonic.com/api-reference/business/list-workflows.md): List the workflows in a project as a filterable inventory, or get the counts of workflows grouped by status.
- [Get a workflow](https://apidocs.writesonic.com/api-reference/business/get-a-workflow.md): Get a single workflow together with a chosen slice of its related data: its details, its versions, one version in full, its run history, or one run in full.
- [List workflow components](https://apidocs.writesonic.com/api-reference/business/list-workflow-components.md): List the building blocks used to assemble workflows: the catalog of available components, a specific set of components fetched by id, or the capabilities offered by the workflows hub.
- [List or read grids](https://apidocs.writesonic.com/api-reference/business/list-or-read-grids.md): List the grids in a project, look at one grid's setup or its processing status, or see the column types you can add to a grid.
- [Read grid data](https://apidocs.writesonic.com/api-reference/business/read-grid-data.md): Read what is inside a grid: its columns, its rows, a single cell, the run behind a computed cell, or the rows matching a search.
- [Search knowledge sources](https://apidocs.writesonic.com/api-reference/business/search-knowledge-sources.md): Search across the project's knowledge sources and get back the most relevant passages, optionally with a generated answer written from them.
- [List or read knowledge sources](https://apidocs.writesonic.com/api-reference/business/list-or-read-knowledge-sources.md): List the project's knowledge sources or the folders that organize them, or read the full content of one source. This does not cover the brand kit, which is a separate resource.
- [Get brand kit](https://apidocs.writesonic.com/api-reference/business/get-brand-kit.md): Get the project's brand kit: list the names of its sections, or compose the brand content into a ready-to-use prompt.
- [Get content-intelligence dashboard](https://apidocs.writesonic.com/api-reference/business/get-content-intelligence-dashboard.md): Returns project-level content-intelligence data for the dashboard: page and live-tracking summaries, the available filters and countries, the ranked list of tracked pages, page groups, and the columns shown in the page list.
- [Get page content-intelligence report](https://apidocs.writesonic.com/api-reference/business/get-page-content-intelligence-report.md): Returns a detailed content-intelligence report for a single tracked page, covering SEO performance, AI citations, conversion funnels, traffic, SERP position, keywords, page lifecycle, or activity.
- [List integrations](https://apidocs.writesonic.com/api-reference/business/list-integrations.md): Lists the third-party apps and integration connections available to the workspace: browse the catalogue of supported apps, see connections grouped by app with active and inactive counts, or list individual connections.
- [Get attachment download URL](https://apidocs.writesonic.com/api-reference/business/get-attachment-download-url.md): Get a short-lived link for downloading a file attached to a task or a comment.
- [MCP Server](https://apidocs.writesonic.com/agents-mcp/mcp-server.md): Connect Writesonic Agents to Claude, ChatGPT, and other MCP-compatible assistants. Manage tasks, playbooks, grids, knowledge base, and pages from chat.
- [Setup Guide](https://apidocs.writesonic.com/agents-mcp/setup.md): Step-by-step instructions for connecting the Writesonic Agents MCP server to your AI assistant.
- [Tools Reference](https://apidocs.writesonic.com/agents-mcp/tools-reference.md): Every tool the Writesonic Agents MCP server exposes, what it does, and its REST equivalent.
- [Use Cases & Examples](https://apidocs.writesonic.com/agents-mcp/examples.md): Real prompts and end-to-end examples for the Writesonic Agents MCP server.

## OpenAPI Specs

- [openapi](https://apidocs.writesonic.com/api-reference/openapi.json)
- [openapi-public](https://apidocs.writesonic.com/openapi-public.json)

## Optional

- [Open Writesonic](https://app.writesonic.com/?utm_source=docs)
- [Book a demo](https://writesonic.com/?demo=open)