Skip to main content
Base path: /v1/ai/generate AI visibility endpoints measure how your website and competitors appear across AI models. These are the primary API routes for integrating Krastie into analytics dashboards, agency workflows, or custom reporting tools.
Each report refresh counts toward your plan’s AI refresh usage usage. See the pricing page for refresh limits on your plan.

​
POST /seo-site-report

Start a new visibility report or refresh an existing one. Body:
FieldTypeRequiredDescription
websiteurlstringYes*Site to analyze (*required for new reports)
competitorsstring[]NoCompetitor domains for comparison
promptsstring[]NoNatural-language queries to test
refreshbooleanNoSet true to refresh the latest report
New report example: 
curl -X POST https://api.krastie.ai/v1/ai/generate/seo-site-report \
  -H "Content-Type: application/json" \
  -H "api-key: krastie_YOUR_KEY" \
  -d '{
    "websiteurl": "https://example.com",
    "competitors": ["https://competitor-a.com", "https://competitor-b.com"],
    "prompts": [
      "best AI visibility tools",
      "how to get mentioned in ChatGPT"
    ]
  }'
Refresh example: 
curl -X POST https://api.krastie.ai/v1/ai/generate/seo-site-report \
  -H "Content-Type: application/json" \
  -H "api-key: krastie_YOUR_KEY" \
  -d '{"refresh": true}'
Response: Report object with visibility scores, per-prompt results, competitor comparisons, and recommendations.

​
POST /seo-site-report/prefill

Suggest competitors and prompts before running a full report. Body:
FieldTypeRequiredDescription
websiteurlstringYesSite to analyze
curl -X POST https://api.krastie.ai/v1/ai/generate/seo-site-report/prefill \
  -H "Content-Type: application/json" \
  -H "api-key: krastie_YOUR_KEY" \
  -d '{"websiteurl": "https://example.com"}'
Use the returned suggestions to populate a full report request.

​
GET /seo-site-report

Fetch the latest visibility report for the authenticated workspace. 
curl https://api.krastie.ai/v1/ai/generate/seo-site-report \
  -H "api-key: krastie_YOUR_KEY"

​
GET /seo-site-report/history

Retrieve historical visibility data to track mention rates, citation rates, and competitor positioning over time. 
curl https://api.krastie.ai/v1/ai/generate/seo-site-report/history \
  -H "api-key: krastie_YOUR_KEY"

​
GET /assistant/context

Returns workspace summary data available to the assistant, including visibility metrics, traffic, and documents. 
curl https://api.krastie.ai/v1/ai/generate/assistant/context \
  -H "api-key: krastie_YOUR_KEY"
Use this endpoint to verify what visibility data is available before calling chat with useWorkspaceContext: true.

​
Report data model

Reports typically include:
FieldDescription
Visibility scoreAggregate performance across prompts and models
Prompt resultsPer-query mention and citation status
Competitor metricsSide-by-side comparison data
Model breakdownResults segmented by AI provider
RecommendationsPrioritized actions with difficulty ratings
Exact field names may vary by API version. Treat responses as the source of truth for your integration.

​
Workflow example

# 1. Prefill competitors and prompts
curl -X POST https://api.krastie.ai/v1/ai/generate/seo-site-report/prefill \
  -H "Content-Type: application/json" \
  -H "api-key: krastie_YOUR_KEY" \
  -d '{"websiteurl": "https://example.com"}'

# 2. Run the full report
curl -X POST https://api.krastie.ai/v1/ai/generate/seo-site-report \
  -H "Content-Type: application/json" \
  -H "api-key: krastie_YOUR_KEY" \
  -d '{
    "websiteurl": "https://example.com",
    "competitors": ["https://competitor.com"],
    "prompts": ["best tools for AI search visibility"]
  }'

# 3. Poll history after implementing recommendations
curl https://api.krastie.ai/v1/ai/generate/seo-site-report/history \
  -H "api-key: krastie_YOUR_KEY"
Content tools that support visibility improvements are documented separately: