For Developers

Foglift API & MCP Server

Scan any website for SEO + GEO issues right from your terminal, CI/CD pipeline, or AI coding assistant. Free tier included — no API key required.

Try in Playground

Quick Start

Make a GET request to the scan endpoint. No authentication needed for basic scans.

# Scan a website (JSON response)
curl "https://foglift.io/api/v1/scan?url=example.com"

# Plain text output (great for terminal)
curl "https://foglift.io/api/v1/scan?url=example.com&format=text"

API Reference

GET/api/v1/scan

Parameters

Parameter	Type	Required	Description
`url`	string	Yes	The URL to scan (e.g., example.com or https://example.com)
`format`	string	No	"json" (default) or "text" for terminal-friendly output

Example Response

{
  "url": "https://example.com",
  "scores": {
    "overall": 72,
    "seo": 85,
    "geo": 60,
    "performance": 78,
    "security": 45,
    "accessibility": 90
  },
  "topIssues": [
    {
      "category": "GEO",
      "severity": "critical",
      "title": "AI engines can't understand your business",
      "description": "Add JSON-LD structured data..."
    },
    {
      "category": "Security",
      "severity": "critical",
      "title": "Missing HSTS header",
      "description": "Enable HTTP Strict Transport Security..."
    }
  ],
  "totalIssues": 8,
  "fullReport": "https://foglift.io/scan/abc123",
  "upgrade": "https://foglift.io/pricing",
  "_meta": {
    "tool": "Foglift",
    "version": "1.0",
    "docs": "https://foglift.io/developers"
  }
}

GEO Monitor API Pro+

Track how AI search engines mention your brand. Requires an API key — generate one in Settings → Developer.

Authentication

Include your API key in the X-API-Key header:

curl -H "X-API-Key: sk_fog_YOUR_KEY" \
  "https://foglift.io/api/v1/monitor?workspace_id=YOUR_ID"

GET/api/v1/monitorPro+

Read GEO monitoring results — visibility scores, model breakdown, citations, and trends.

Parameters

`workspace_id`	string	Your workspace ID (find in Settings → Developer)
`period`	string	"7d" (default), "14d", or "30d"

POST/api/v1/monitor/runEnterprise+

Trigger an on-demand GEO scan. Enterprise plan only.

Tier	Read Results (GET)	Trigger Runs (POST)	API Access
Free / Launch	No	No	No
Growth ($129/mo)	Yes (100/day)	No (scheduled only)	Read
Enterprise ($299/mo)	Yes (1,000/day)	Yes (10/day)	Read + Write

Batch Scan API

Scan multiple URLs in a single request. Requires an API key (Launch plan or higher).

POST/api/v1/scan/batch

Request Body

{
  "urls": [
    "https://example.com",
    "https://another-site.com",
    "https://third-site.com"
  ]
}

Example

curl -X POST "https://foglift.io/api/v1/scan/batch" \
  -H "X-API-Key: sk_fog_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["example.com","google.com","github.com"]}'

Limits

Maximum 10 URLs per request
Requires API key authentication (Launch+ plan)
Each URL counts against your daily rate limit
URLs are scanned with controlled concurrency (3 at a time)

Rate Limits

Tier	Rate Limit	Issues Shown	Price
Free API	15 scans/day	All issues + AI plan	$0
Growth API	Unlimited	All issues + AI plan + webhooks	From $129/mo

Content Intelligence APIs

Advanced APIs for AI content optimization, content briefs, and crawler analytics.

GET/api/v1/aeo-score

Get a detailed AEO (AI Engine Optimization) content score. Evaluates 8 dimensions: structured data, heading clarity, FAQ quality, entity identity, content depth, citation formatting, topical authority, and AI crawler access.

curl "https://foglift.io/api/v1/aeo-score?url=https://example.com"

# Response: { aeoScore: 72, grade: "C", dimensions: [...], topRecommendations: [...] }

GET/api/v1/content-brief

Generate an actionable content brief with target prompts to optimize for, content gaps, structure recommendations, and estimated impact on AI-citability.

curl "https://foglift.io/api/v1/content-brief?url=https://example.com"

# Response: { targetPrompts: [...], contentGaps: [...], structureRecommendations: [...] }

GET/api/v1/crawler-analytics

Track AI crawler visits (GPTBot, ClaudeBot, PerplexityBot, etc.) to your site. See which AI engines are indexing your content and which pages they visit most.

curl "https://foglift.io/api/v1/crawler-analytics?days=30"

# Response: { totalVisits: 142, byEngine: { ChatGPT: 52, ... }, topPaths: [...] }

GETPOSTDELETE/api/v1/prompts

CRUD for GEO monitoring prompts. List, create, and delete prompts for your workspace. Requires API key.

# List prompts
curl -H "X-API-Key: YOUR_KEY" "https://foglift.io/api/v1/prompts?workspace_id=ID"

# Add prompts
curl -X POST -H "X-API-Key: YOUR_KEY" \
  -d '{"workspace_id":"ID","prompts":[{"text":"Best tools for..."}]}' \
  "https://foglift.io/api/v1/prompts"

# Delete a prompt
curl -X DELETE -H "X-API-Key: YOUR_KEY" \
  -d '{"workspace_id":"ID","prompt_id":"PROMPT_ID"}' \
  "https://foglift.io/api/v1/prompts"

GET/api/v1/history

Fetch GEO monitoring results history with visibility trends and per-model breakdown. Supports pagination and filtering.

curl -H "X-API-Key: YOUR_KEY" \
  "https://foglift.io/api/v1/history?workspace_id=ID&limit=20"

# Response: { results: [...], visibilityRate: 45, byModel: { ChatGPT: {...} } }

MCP Server for AI Coding Assistants

Use Foglift directly in Claude Code, Cursor, or any MCP-compatible AI assistant. Get SEO + GEO analysis while you build your website.

Install via npm

npx foglift-mcp

Claude Code Setup

Add this to your ~/.claude/mcp.json or project .mcp.json file:

{
  "mcpServers": {
    "foglift": {
      "command": "npx",
      "args": ["foglift-mcp"]
    }
  }
}

13 tools available: scan_website, batch_scan, run_ai_visibility, get_ai_results, get_prompts, add_prompts, delete_prompt, get_models, set_models, get_sentiment, get_usage, get_scan_history, get_geo_monitor.

Use in Any Terminal

# Quick scan from your terminal
curl -s "https://foglift.io/api/v1/scan?url=mysite.com&format=text"

# JSON for scripts and CI/CD
curl -s "https://foglift.io/api/v1/scan?url=mysite.com" | jq '.scores'

# Check GEO readiness
curl -s "https://foglift.io/api/v1/scan?url=mysite.com" | jq '.scores.geo'

CLI Tool

Run scans, manage prompts, and check AI visibility directly from your terminal with colored output and JSON export.

Install

npm install -g foglift-scan

Commands

# Website audit with colored terminal output
foglift scan https://example.com

# JSON output for scripts
foglift scan https://example.com --json

# Fail CI if score below threshold
foglift scan https://example.com --threshold 70

# AI visibility check (requires API key via FOGLIFT_API_KEY)
foglift scan ai-check --prompt "best tools for marketing" --models chatgpt,perplexity

# Get historical AI visibility results
foglift scan results --days 7 --model chatgpt

# Manage monitoring prompts
foglift scan prompts list
foglift scan prompts add "best alternatives to semrush"

# Check token usage
foglift scan usage

Zapier Integration

Connect Foglift to 7,000+ apps via Zapier. Trigger scans from form submissions, send results to Slack, update spreadsheets with scores, and more — no code required.

Triggers

New scan result
New AI visibility result

Actions

Run website scan
Run AI visibility check
Add monitoring prompt

Searches

Find scan by URL
Get sentiment analysis

Learn more about the Zapier integration →

Use Cases

CI/CD Pipeline

Add SEO + GEO checks to your deployment pipeline. Catch issues before they go live.

AI Coding Assistants

Let Claude Code, Cursor, or Copilot check your site's SEO while you build it.

Client Reports

Agencies can automate website audits for client proposals and ongoing monitoring.

Monitoring Scripts

Build custom monitoring that tracks your SEO + GEO scores over time.

Ready to integrate?

Start scanning for free. No API key required.

Try a Scan View Pricing

For Developers

Foglift API & MCP Server

Scan any website for SEO + GEO issues right from your terminal, CI/CD pipeline, or AI coding assistant. Free tier included — no API key required.

Try in Playground

Quick Start

Make a GET request to the scan endpoint. No authentication needed for basic scans.

# Scan a website (JSON response)
curl "https://foglift.io/api/v1/scan?url=example.com"

# Plain text output (great for terminal)
curl "https://foglift.io/api/v1/scan?url=example.com&format=text"

API Reference

GET/api/v1/scan

Parameters

Parameter	Type	Required	Description
`url`	string	Yes	The URL to scan (e.g., example.com or https://example.com)
`format`	string	No	"json" (default) or "text" for terminal-friendly output

Example Response

{
  "url": "https://example.com",
  "scores": {
    "overall": 72,
    "seo": 85,
    "geo": 60,
    "performance": 78,
    "security": 45,
    "accessibility": 90
  },
  "topIssues": [
    {
      "category": "GEO",
      "severity": "critical",
      "title": "AI engines can't understand your business",
      "description": "Add JSON-LD structured data..."
    },
    {
      "category": "Security",
      "severity": "critical",
      "title": "Missing HSTS header",
      "description": "Enable HTTP Strict Transport Security..."
    }
  ],
  "totalIssues": 8,
  "fullReport": "https://foglift.io/scan/abc123",
  "upgrade": "https://foglift.io/pricing",
  "_meta": {
    "tool": "Foglift",
    "version": "1.0",
    "docs": "https://foglift.io/developers"
  }
}

GEO Monitor API Pro+

Track how AI search engines mention your brand. Requires an API key — generate one in Settings → Developer.

Authentication

Include your API key in the X-API-Key header:

curl -H "X-API-Key: sk_fog_YOUR_KEY" \
  "https://foglift.io/api/v1/monitor?workspace_id=YOUR_ID"

GET/api/v1/monitorPro+

Read GEO monitoring results — visibility scores, model breakdown, citations, and trends.

Parameters

`workspace_id`	string	Your workspace ID (find in Settings → Developer)
`period`	string	"7d" (default), "14d", or "30d"

POST/api/v1/monitor/runEnterprise+

Trigger an on-demand GEO scan. Enterprise plan only.

Tier	Read Results (GET)	Trigger Runs (POST)	API Access
Free / Launch	No	No	No
Growth ($129/mo)	Yes (100/day)	No (scheduled only)	Read
Enterprise ($299/mo)	Yes (1,000/day)	Yes (10/day)	Read + Write

Batch Scan API

Scan multiple URLs in a single request. Requires an API key (Launch plan or higher).

POST/api/v1/scan/batch

Request Body

{
  "urls": [
    "https://example.com",
    "https://another-site.com",
    "https://third-site.com"
  ]
}

Example

curl -X POST "https://foglift.io/api/v1/scan/batch" \
  -H "X-API-Key: sk_fog_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["example.com","google.com","github.com"]}'

Limits

Maximum 10 URLs per request
Requires API key authentication (Launch+ plan)
Each URL counts against your daily rate limit
URLs are scanned with controlled concurrency (3 at a time)

Rate Limits

Tier	Rate Limit	Issues Shown	Price
Free API	15 scans/day	All issues + AI plan	$0
Growth API	Unlimited	All issues + AI plan + webhooks	From $129/mo

Content Intelligence APIs

Advanced APIs for AI content optimization, content briefs, and crawler analytics.

GET/api/v1/aeo-score

curl "https://foglift.io/api/v1/aeo-score?url=https://example.com"

# Response: { aeoScore: 72, grade: "C", dimensions: [...], topRecommendations: [...] }

GET/api/v1/content-brief

Generate an actionable content brief with target prompts to optimize for, content gaps, structure recommendations, and estimated impact on AI-citability.

curl "https://foglift.io/api/v1/content-brief?url=https://example.com"

# Response: { targetPrompts: [...], contentGaps: [...], structureRecommendations: [...] }

GET/api/v1/crawler-analytics

Track AI crawler visits (GPTBot, ClaudeBot, PerplexityBot, etc.) to your site. See which AI engines are indexing your content and which pages they visit most.

curl "https://foglift.io/api/v1/crawler-analytics?days=30"

# Response: { totalVisits: 142, byEngine: { ChatGPT: 52, ... }, topPaths: [...] }

GETPOSTDELETE/api/v1/prompts

CRUD for GEO monitoring prompts. List, create, and delete prompts for your workspace. Requires API key.

# List prompts
curl -H "X-API-Key: YOUR_KEY" "https://foglift.io/api/v1/prompts?workspace_id=ID"

# Add prompts
curl -X POST -H "X-API-Key: YOUR_KEY" \
  -d '{"workspace_id":"ID","prompts":[{"text":"Best tools for..."}]}' \
  "https://foglift.io/api/v1/prompts"

# Delete a prompt
curl -X DELETE -H "X-API-Key: YOUR_KEY" \
  -d '{"workspace_id":"ID","prompt_id":"PROMPT_ID"}' \
  "https://foglift.io/api/v1/prompts"

GET/api/v1/history

Fetch GEO monitoring results history with visibility trends and per-model breakdown. Supports pagination and filtering.

curl -H "X-API-Key: YOUR_KEY" \
  "https://foglift.io/api/v1/history?workspace_id=ID&limit=20"

# Response: { results: [...], visibilityRate: 45, byModel: { ChatGPT: {...} } }

MCP Server for AI Coding Assistants

Use Foglift directly in Claude Code, Cursor, or any MCP-compatible AI assistant. Get SEO + GEO analysis while you build your website.

Install via npm

npx foglift-mcp

Claude Code Setup

Add this to your ~/.claude/mcp.json or project .mcp.json file:

{
  "mcpServers": {
    "foglift": {
      "command": "npx",
      "args": ["foglift-mcp"]
    }
  }
}

Use in Any Terminal

# Quick scan from your terminal
curl -s "https://foglift.io/api/v1/scan?url=mysite.com&format=text"

# JSON for scripts and CI/CD
curl -s "https://foglift.io/api/v1/scan?url=mysite.com" | jq '.scores'

# Check GEO readiness
curl -s "https://foglift.io/api/v1/scan?url=mysite.com" | jq '.scores.geo'

CLI Tool

Run scans, manage prompts, and check AI visibility directly from your terminal with colored output and JSON export.

Install

npm install -g foglift-scan

Commands

# Website audit with colored terminal output
foglift scan https://example.com

# JSON output for scripts
foglift scan https://example.com --json

# Fail CI if score below threshold
foglift scan https://example.com --threshold 70

# AI visibility check (requires API key via FOGLIFT_API_KEY)
foglift scan ai-check --prompt "best tools for marketing" --models chatgpt,perplexity

# Get historical AI visibility results
foglift scan results --days 7 --model chatgpt

# Manage monitoring prompts
foglift scan prompts list
foglift scan prompts add "best alternatives to semrush"

# Check token usage
foglift scan usage

Zapier Integration

Connect Foglift to 7,000+ apps via Zapier. Trigger scans from form submissions, send results to Slack, update spreadsheets with scores, and more — no code required.

Triggers

New scan result
New AI visibility result

Actions

Run website scan
Run AI visibility check
Add monitoring prompt

Searches

Find scan by URL
Get sentiment analysis

Learn more about the Zapier integration →

Use Cases

CI/CD Pipeline

Add SEO + GEO checks to your deployment pipeline. Catch issues before they go live.

AI Coding Assistants

Let Claude Code, Cursor, or Copilot check your site's SEO while you build it.

Client Reports

Agencies can automate website audits for client proposals and ongoing monitoring.

Monitoring Scripts

Build custom monitoring that tracks your SEO + GEO scores over time.

Ready to integrate?

Start scanning for free. No API key required.

Try a Scan View Pricing