Skip to main content

Citation Tracking

Start Citation Tracking

POST /api/v1/geo/citation-tracking/start Initiates citation tracking for an audit across LLMs.
audit_id
integer
required
Audit ID to track
industry
string
default:"general"
Industry vertical
keywords
array
Keywords to track citations for
llm_name
string
default:"kimi"
LLM to query (kimi, chatgpt, perplexity)

Get Citation History

GET /api/v1/geo/citation-tracking/history/{audit_id} Returns historical citation data.
days
integer
default:"30"
Number of days of history

Get Recent Citations

GET /api/v1/geo/citation-tracking/recent/{audit_id} Returns recent citations where your brand was mentioned.
limit
integer
default:"10"
Maximum citations to return

Query Discovery

Discover Queries

POST /api/v1/geo/query-discovery/discover Discovers relevant search queries for your niche.
brand_name
string
required
Brand name
domain
string
required
Domain name
industry
string
required
Industry category
keywords
array
required
Seed keywords
total_discovered
integer
Total queries discovered
queries
array
Array of discovered query objects

Get Query Opportunities

GET /api/v1/geo/query-discovery/opportunities/{audit_id} Returns top query opportunities ranked by potential.
limit
integer
default:"10"
Maximum opportunities to return

Competitor Analysis

Analyze Competitor Citations

POST /api/v1/geo/competitor-analysis/analyze Analyzes competitor citation patterns across LLMs.
audit_id
integer
required
Audit ID
competitor_domains
array
required
List of competitor domains
queries
array
required
Queries to analyze

Get Citation Benchmark

GET /api/v1/geo/competitor-analysis/benchmark/{audit_id} Returns citation benchmark comparing your brand against competitors.
has_data
boolean
Whether benchmark data exists
your_mentions
integer
Your brand mention count
competitors
array
Competitor benchmark data
gap_analysis
object
Gap analysis results

Schema Optimizer

Generate Schema

POST /api/v1/geo/schema/generate Generates optimized Schema.org markup for a page.
html_content
string
HTML content of the page
url
string
required
Page URL
page_type
string
Page type (Article, Product, etc.)
page_type
string
Detected or specified page type
implementation_code
string
Generated schema JSON-LD

Generate Multiple Schemas

POST /api/v1/geo/schema/multiple Generates multiple schema types if the page supports them.
total_schemas
integer
Number of schemas generated
schemas
array
Array of schema objects

Content Templates

List Templates

GET /api/v1/geo/content-templates/list Returns all available GEO content templates.
total_templates
integer
Number of templates
templates
array
Template objects

Generate Template

POST /api/v1/geo/content-templates/generate Generates a customized content template.
template_type
string
required
Template type (guide, comparison, faq, listicle, tutorial)
topic
string
required
Content topic
keywords
array
required
Target keywords

Analyze Content

POST /api/v1/geo/content-templates/analyze Analyzes existing content for GEO readiness.
content
string
required
Content to analyze
score
integer
GEO readiness score (0-100)
strengths
array
Content strengths
improvements
array
Suggested improvements

Commerce Query Analyzer

Analyze Commerce Query

POST /api/v1/geo/commerce-query/analyze Analyzes a commerce query using Kimi 2.5 search.
audit_id
integer
required
Audit ID
query
string
required
Commerce query to analyze
market
string
required
Market code (AR, US, MX, etc.)
top_k
integer
default:"10"
Number of results to analyze (1-20)
analysis_id
integer
Analysis ID
target_position
integer
Your domain’s position in results
top_result
object
Top ranking result details
why_not_first
array
Reasons why you’re not #1
action_plan
array
Actionable steps to improve ranking

Article Engine

Generate Article Batch

POST /api/v1/geo/article-engine/generate Generates a batch of GEO-optimized articles.
audit_id
integer
required
Audit ID
article_count
integer
default:"3"
Number of articles (1-12)
language
string
default:"en"
Content language
tone
string
default:"executive"
Content tone
include_schema
boolean
default:"true"
Include schema markup
run_async
boolean
default:"true"
Run asynchronously
batch_id
integer
Article batch ID
status
string
Batch status (pending, processing, completed, failed)

Get Article Batch Status

GET /api/v1/geo/article-engine/status/{batch_id} Returns the status of an article generation batch.

GEO Dashboard

GET /api/v1/geo/dashboard/{audit_id} Returns a comprehensive GEO dashboard with all features.
citation_tracking
object
Citation metrics and rates
top_opportunities
array
Query opportunities
competitor_benchmark
object
Competitor comparison data
commerce_campaign
object
Latest commerce campaign data
article_engine
object
Latest article batch data

Error Codes

400
error
Invalid input parameters
422
error
Article data pack incomplete or insufficient authority sources
502
error
Kimi generation failed
503
error
Kimi service unavailable

Build docs developers (and LLMs) love