# Finseo ## Docs ### Overview - [Introduction](https://docs.finseo.ai/index.md): The Finseo API gives you programmatic access to your AI visibility tracking data. - [API Authentication & API Keys](https://docs.finseo.ai/authentication.md): How to authenticate with the Finseo API using API keys. - [Finseo API Rate Limits](https://docs.finseo.ai/rate-limits.md): API rate limits per pricing plan. - [Changelog](https://docs.finseo.ai/changelog.md): Latest changes to the Finseo API. ### Getting Started - [Set Up Prompt Tracking](https://docs.finseo.ai/getting-started/prompts.md): Learn how to choose and add prompts that measure your AI visibility. - [Choose AI Models to Track](https://docs.finseo.ai/getting-started/models.md): Configure which AI models Finseo uses for prompt tracking. - [KPIs & Metrics Explained — AI Visibility Measurement](https://docs.finseo.ai/getting-started/kpis.md): Every Finseo metric explained in plain language, with formulas and worked examples — Visibility, Mention Rate, Citation Rate, Share of Voice, Position, Mention Depth, Citations, Sentiment and more. ### Analytics - [Track AI Crawlers with Bot Analytics](https://docs.finseo.ai/bot-analytics.md): Upload server logs to see how AI crawlers access your website. - [Measure Human Traffic from AI Search](https://docs.finseo.ai/human-traffic.md): Connect analytics data to measure visits, conversions, and revenue from AI platforms. - [Set Up AI Search Attribution: Forms, CRMs & Orders](https://docs.finseo.ai/attribution.md): Connect leads, orders, and revenue to the channels customers actually found you through — including AI search. ## Integrations ### Overview - [Integrations](https://docs.finseo.ai/integrations.md): Connect forms, CRMs, analytics tools, project management tools, and CMS platforms to Finseo. ### Analytics - [Connect Google Analytics (GA4) to Finseo](https://docs.finseo.ai/integrations/google-analytics.md): Track AI-referred traffic, conversions and revenue by connecting GA4 to Finseo. - [Connect Piwik PRO to Finseo for AI Traffic Tracking](https://docs.finseo.ai/integrations/piwik-pro.md): Track AI-referred traffic in Finseo with your Piwik PRO analytics data. - [Connect Google & Bing Search Console](https://docs.finseo.ai/search-console.md): Use Google Search Console and Bing Webmaster Tools to find real user prompts. - [Track AI Bot Traffic via Cloudflare](https://docs.finseo.ai/cloudflare-bot-traffic.md): Stream AI crawler visits from Cloudflare to Finseo in near real-time — via Worker (all plans) or Logpush (Enterprise). - [Push Server Logs to Finseo (Custom API)](https://docs.finseo.ai/server-logs-ingest.md): Send AI crawler visits from nginx, Apache or your own server-side tracking to Finseo as NDJSON — no CDN required. ### Reporting & data - [Connect Looker Studio to Finseo](https://docs.finseo.ai/looker-studio.md): Connect your Finseo AI search visibility data to Google Looker Studio. - [Track Products in AI Shopping](https://docs.finseo.ai/products.md): Understand product mentions, AI shopping listings, stores, attributes, and product detail pages. - [Analyze Brand Sentiment in AI Answers](https://docs.finseo.ai/sentiment.md): Analyze how AI describes your brand, competitors, criticisms, and awards. ### CMS & content - [Connect WordPress to Finseo for AEO & GEO](https://docs.finseo.ai/integrations/wordpress.md): Let the Finseo agent optimize your WordPress posts, pages and meta tags for AI visibility. - [Connect Webflow to Finseo for AEO & GEO](https://docs.finseo.ai/integrations/webflow.md): Let the Finseo agent optimize your Webflow CMS items and page SEO settings. - [Connect Framer to Finseo for AEO & GEO](https://docs.finseo.ai/integrations/framer.md): Let the Finseo agent optimize your Framer pages and CMS content via the Server API. - [Connect Shopify to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/shopify.md): Track checkouts for attribution with a Custom Pixel, and optimize your store's AEO & GEO with the Finseo agent (coming soon). ### Project management - [Connect ClickUp to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/clickup.md): Export Finseo tasks into ClickUp lists and assign them to ClickUp members — manually or via automation rules. - [Connect Asana to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/asana.md): Send Finseo tasks into your Asana projects with evidence and action steps attached. - [Connect Linear to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/linear.md): Turn Finseo visibility tasks into Linear issues with full markdown descriptions. - [Connect Jira to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/jira.md): Export Finseo tasks as Jira Cloud issues with formatted descriptions. - [Connect Monday.com to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/monday.md): Push Finseo visibility tasks onto your Monday boards as items. - [Connect Trello to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/trello.md): Create Trello cards from Finseo visibility tasks with markdown descriptions. - [Connect Notion to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/notion.md): Add Finseo visibility tasks as pages to any Notion database. ### Attribution & CRM - [Connect HubSpot to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/hubspot.md): Send "How did you hear about us?" answers from HubSpot workflows to Finseo attribution. - [Connect Salesforce to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/salesforce.md): Send LeadSource and attribution data from Salesforce Flows to Finseo. - [Connect Pipedrive to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/pipedrive.md): Capture deal attribution from Pipedrive Automations in Finseo. - [Connect Attio to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/attio.md): Sync attribution answers from Attio CRM records to Finseo via webhooks. - [Connect Close to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/close.md): Receive lead attribution from Close CRM webhooks in Finseo. - [Connect Typeform to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/typeform.md): Send "How did you find us?" survey answers from Typeform to Finseo. - [Connect Tally to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/tally.md): Send Tally form answers to Finseo attribution — natively supported, no field mapping needed. - [Connect Jotform to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/jotform.md): Receive Jotform survey submissions in Finseo for attribution tracking. - [Connect Gravity Forms to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/gravity-forms.md): Send WordPress Gravity Forms submissions to Finseo attribution via the Webhooks Add-On. - [Connect Formstack to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/formstack.md): Receive Formstack form submissions in Finseo for attribution tracking. - [Connect Calendly to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/calendly.md): Capture "How did you hear about us?" answers from Calendly booking forms in Finseo. - [Connect Intercom to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/intercom.md): Capture attribution from Intercom contact events in Finseo. - [Connect Zapier / Make to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/zapier-make.md): Connect any form or CRM to Finseo attribution via Zapier or Make. - [Connect n8n to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/n8n.md): Build custom attribution workflows into Finseo with the open-source automation tool n8n. - [Connect Custom Webhook to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/custom-webhook.md): Send attribution data to Finseo from any source via the generic webhook endpoint. ### E-commerce & surveys - [Connect Stripe to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/stripe.md): Send Stripe payments to Finseo attribution — amounts, trials, and renewals are classified automatically. - [Connect WooCommerce to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/woocommerce.md): Send WooCommerce orders to Finseo attribution with a native order webhook. - [Connect Shopware to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/shopware.md): Send Shopware orders to Finseo attribution with a Flow Builder webhook. - [Connect Fairing to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/fairing.md): Import Fairing post-purchase survey answers into Finseo attribution via Shopify Flow. - [Connect KnoCommerce to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/knocommerce.md): Import KnoCommerce post-purchase survey answers into Finseo attribution via webhook. - [Connect Zigpoll to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/zigpoll.md): Import Zigpoll survey answers into Finseo attribution via native webhooks. - [Connect SurveyMonkey to Finseo for AI Search Attribution](https://docs.finseo.ai/integrations/surveymonkey.md): Import SurveyMonkey answers into Finseo attribution via Zapier or Make. ## API ### Guides - [Automate a pitch](https://docs.finseo.ai/api-reference/guides/automate-pitch.md): Create a pitch project, set its models, add prompts, read the results and convert a won pitch — the full agency flow in five API calls. - [Entity levels](https://docs.finseo.ai/api-reference/guides/entity-levels.md): Evaluate every KPI per company, brand line, product or ingredient — same counting, different grouping. ### Projects - [List Projects](https://docs.finseo.ai/api-reference/projects/list.md) - [Get Project](https://docs.finseo.ai/api-reference/projects/get.md) - [Create Project](https://docs.finseo.ai/api-reference/projects/create.md) - [Update Project](https://docs.finseo.ai/api-reference/projects/update.md) ### Prompts - [List Prompts](https://docs.finseo.ai/api-reference/prompts/list.md) - [Create Prompt](https://docs.finseo.ai/api-reference/prompts/add.md) ### Metrics - [Project Metrics (Summary)](https://docs.finseo.ai/api-reference/metrics/daily.md) - [Metrics Timeseries](https://docs.finseo.ai/api-reference/metrics/timeseries.md) ### Competitors - [List Competitors](https://docs.finseo.ai/api-reference/competitors/ranking.md) ### Sources - [List Sources](https://docs.finseo.ai/api-reference/sources/ranking.md) ### Tags - [List Tags](https://docs.finseo.ai/api-reference/tags/list.md) - [Apply Tag to Prompts](https://docs.finseo.ai/api-reference/tags/create.md) ### Fan-outs - [List Fan-outs](https://docs.finseo.ai/api-reference/fanouts/list.md): Get the AI query fan-outs (related sub-queries that AI models generated while answering your tracked prompts), aggregated and ranked by frequency. - [Get Fan-out Details](https://docs.finseo.ai/api-reference/fanouts/details.md): Get per-occurrence details for a single fan-out query — every tracking result whose fan-out queries contain this exact text. ### Tasks - [List Tasks](https://docs.finseo.ai/api-reference/tasks/list.md): List the AI-generated optimization tasks for a project — concrete, prioritized to-dos derived from your visibility data, sorted by priority score. - [Get Task](https://docs.finseo.ai/api-reference/tasks/get.md): Read one optimization task in full — description, step-by-step action plan, the evidence that triggered it, and the structured content plan for content tasks. ### Export - [Export Project Data](https://docs.finseo.ai/api-reference/export/bulk.md) ### Attribution - [List Attributions](https://docs.finseo.ai/api-reference/attribution/list.md) - [Create Attribution](https://docs.finseo.ai/api-reference/attribution/submit.md) - [Get Attribution Summary](https://docs.finseo.ai/api-reference/attribution/summary.md) - [Bulk Create Attributions](https://docs.finseo.ai/api-reference/attribution/bulk.md) ## MCP ### MCP Integration - [Finseo MCP Server: Claude, ChatGPT & Cursor](https://docs.finseo.ai/mcp/overview.md): Connect Finseo to AI assistants like Claude, ChatGPT and Cursor. - [Connect Finseo MCP to Claude](https://docs.finseo.ai/mcp/claude-desktop.md): Connect Finseo to claude.ai and Claude Desktop as a custom connector. - [Connect Finseo MCP to ChatGPT](https://docs.finseo.ai/mcp/chatgpt.md): Connect Finseo to ChatGPT via developer mode (MCP apps). - [Connect Finseo MCP to Cursor](https://docs.finseo.ai/mcp/cursor.md): Connect Finseo MCP to Cursor IDE. ## Other - [AGENTS](https://docs.finseo.ai/AGENTS.md) ## OpenAPI Specs - [openapi](/openapi.yaml) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [German (78 pages)](https://docs.finseo.ai/_llms/de.txt): Documentation for German. - [French (78 pages)](https://docs.finseo.ai/_llms/fr.txt): Documentation for French. - [Italian (78 pages)](https://docs.finseo.ai/_llms/it.txt): Documentation for Italian. - [Spanish (78 pages)](https://docs.finseo.ai/_llms/es.txt): Documentation for Spanish. - [Portuguese (78 pages)](https://docs.finseo.ai/_llms/pt.txt): Documentation for Portuguese. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.