Do I need to learn an SDK to use Foglift?

No. Foglift exposes a typed REST API at /api/v1/*. Any HTTP client works. The CLI, MCP server, and npm tracker are thin wrappers around the same endpoints. You can swap between surfaces without rewriting your integration.

Can I self-host Foglift?

Not today. Foglift is a hosted platform. We run the scans, hold the AI engine credentials, and store the historical visibility data. The CLI and MCP server are open in the sense that you install them locally, but they call our API.

What rate limits apply to the API?

The unauthenticated public scan endpoint allows 10 API scans per day from one IP. Launch ($49/mo) gets 50 scans/day and 1,000/month, Growth ($129/mo) gets 200/day and 5,000/month, and Enterprise ($299/mo) gets 1,000/day and 25,000/month. Paid plans also include scheduled AI Visibility monitoring tokens.

How is Foglift different from Profound or Otterly?

Profound and Otterly position to marketing teams and ship dashboard-first products. Foglift positions to founders and engineers and ships CLI, MCP, REST, and webhooks as first-class surfaces. The same data is available in the dashboard, but you do not have to log in to use it.

Can I use Foglift in CI?

Yes. The CLI exposes a --threshold flag for use in GitHub Actions or any CI runner. Combine it with npx foglift-scan scan --json and fail the build on score regression. The same pattern works for pre-commit hooks and pre-release pipelines.

What languages and runtimes work with the REST API?

Any language with an HTTP client. We publish TypeScript types via the tracker npm package, but the API is plain JSON over HTTPS. Auth is a single header (X-API-Key). No SDK is required.

For Developers

AI search visibility you can integrate.

Foglift tracks, monitors, and responds to how ChatGPT, Claude, Perplexity, Gemini, and Google AI Overview cite your brand. Available as a typed REST API, an MCP server, a CLI, and an npm tracker. The same data the dashboard shows is available everywhere you ship code.

Get an API key Open the playground

Free tier requires no API key. Paid plans start at $49/mo.

5-minute integration

One of our paying customers shipped from signup to first scan in 6 minutes: Stripe checkout, API key, CLI install, working integration. Pick the surface that matches where you already work.

REST API (no install)

Curl a public scan. No key needed.

curl "https://foglift.io/api/v1/scan?url=example.com"

CLI

Run from terminal or CI. Colored output, JSON, threshold gating.

npm install -g foglift-scan
foglift scan https://example.com --json

MCP server (Claude Code, Cursor, Windsurf)

13 tools available inside your AI editor.

// ~/.claude/mcp.json
{
  "mcpServers": {
    "foglift": {
      "command": "npx",
      "args": ["foglift-mcp"]
    }
  }
}

npm tracker

Record AI crawler hits from your own site.

npm install foglift-tracker

import { track } from "foglift-tracker";
track({ apiKey: process.env.FOGLIFT_API_KEY });

What developers build with Foglift

Three patterns we see most often from teams that wire Foglift in directly.

CI/CD gating

Scan every pull request against your tracked prompts. Fail the build if AI Readiness drops below threshold. Same pattern as Lighthouse CI, applied to AI search.

# .github/workflows/foglift.yml
- run: npx foglift-scan scan https://preview-${{ github.sha }}.example.com --threshold 75

Custom dashboards and observability

Pull visibility history, sentiment, and citation data from /api/v1/historyinto Grafana, Metabase, your internal BI tool, or a Notion database. AI search visibility becomes a metric your team already watches alongside latency and conversion.

curl -H "X-API-Key: $FOGLIFT_KEY" \
  "https://foglift.io/api/v1/history?brand_id=$BRAND_ID&limit=100" \
  | jq '.results[] | {date, visibility_rate, by_model}'

Replace $BRAND_ID with your brand UUID from /dashboard/developer. Required on multi-brand accounts; single-brand accounts auto-resolve.

Agentic content workflows

The MCP server lets Claude Code or Cursor refactor a page, re-scan it, and iterate. The agent sees the live AI Readiness score and dimension breakdown in the same loop where it writes the markup. Closed-loop AI Readiness without leaving the editor.

# In Cursor or Claude Code, with the MCP server installed:
"Scan /pricing on the preview deploy, then add FAQ schema to fix the
top recommendation, then re-scan and report the delta."

API surface at a glance

Nine endpoints cover the full platform. Full reference in /docs.

Endpoint	Verb	Purpose
/api/v1/scan	GET	Public technical audit. No key. AI Readiness + SEO + security + a11y scores in JSON or text.
/api/v1/scan/batch	POST	Scan up to 10 URLs in one request. API key required.
/api/v1/aeo-score	GET	Detailed AI Readiness breakdown across 8 dimensions, grade, top recommendations.
/api/v1/content-brief	GET	Target prompts, content gaps, structure recommendations for a page.
/api/v1/monitor	GET	Read AI Visibility results, model breakdown, citations, and trends. Launch+.
/api/v1/monitor/run	POST	Trigger on-demand AI Visibility scan. Enterprise.
/api/v1/prompts	GET/POST/DELETE	CRUD for monitoring prompts. API key required.
/api/v1/history	GET	Paginated visibility history with per-model breakdown.
/api/v1/crawler-analytics	GET	AI bot visits to your site (GPTBot, ClaudeBot, PerplexityBot, etc.).

Authenticate with an X-API-Key header. Generate keys and copy brand UUIDs in Dashboard → Developer.

Pricing for builders

The Launch plan exists for solo founders and small teams who want the full API, MCP, and CLI surface without committing to an agency-tier price.

Launch

$49/mo

API + MCP + CLI

•4,000 tokens/mo
•Daily AI Visibility monitoring
•All 5 AI engines
•3 brands tracked
•100 API reads/day

Growth

$129/mo

Twice-daily monitoring

•11,500 tokens/mo
•Twice-daily monitoring
•10 brands tracked
•1,000 API reads/day
•Webhooks

Enterprise

$299/mo

Read + write API

•27,000 tokens/mo
•Hourly monitoring
•Unlimited brands
•Unlimited API reads
•10 on-demand scan triggers/day

Free tier (no API key) gets public scan access with per-IP limits. Full plan comparison on /pricing.

Ready to wire it up?

Generate an API key in your dashboard. Or open the docs and try a public scan first.

Get an API key Read the docs

For AI-first founders

A working series on AI search visibility from the operator’s seat. Written for founders shipping AI-native products who care about how their own brand surfaces in ChatGPT, Claude, Perplexity, Gemini, and Google AI Overview.

Live