What it is
The AI Visibility API gives you programmatic access to the AI Visibility data available inside Keyword.com.
It allows you to retrieve:
Brand-level visibility metrics
Sentiment analytics
Citation data
Competitor benchmarks
Topic-level performance
Engine-level breakdowns
Historical time-series data
The API is designed for high-level reporting and analytics, not for retrieving raw AI-generated responses.
If you already use the Keyword.com SERP API, authentication and request structure will feel familiar
Why it matters
The API enables you to:
Automate AI visibility reporting
Build custom dashboards
Feed internal BI systems
Store data in your own warehouse
Combine AI search data with SEO, paid, CRM, or revenue data
Trigger alerts or workflows based on visibility changes
For growing teams, exports eventually become limiting. The API provides:
Scalability
Automation
Full data control
Enterprise-grade integration
How it works
The API uses:
Bearer token authentication
Your existing Keyword.com API credentials
Domain-based metric endpoints
Once authenticated, you can retrieve AI Visibility metrics filtered by:
Topics
Search terms
AI engines
Timeframe
Aggregation level
Historical offsets
Example request:
curl --location -g 'https://app.keyword.com/api/v2/ai-visibility/domains/{{domain_id}}/metrics?timeframe=1y&period_offset=0&aggregation=monthly'
The API returns structured JSON data ready for:
Dashboards
BI tools
Data pipelines
Product integrations
You can access the full API documentation by going to docs.keyword.com/aiv
What data you can retrieve
The AI Visibility API focuses on aggregated metrics and reporting-level data
1. Brand-level visibility metrics
You can retrieve:
Visibility score
Sentiment score
Mentions
Citations
Average position
Detection rate
Top 3 visibility
Trend comparisons
Historical time-series data
Time-series data can be aggregated: Hourly, Daily, Weekly or Monthly
This is ideal for building:
Visibility trend dashboards
Executive KPI reports
Performance comparisons
2. Competitor benchmarks
The API returns competitor metrics including:
Visibility score per competitor
Average rank
Sentiment
Detection rate
Top 3 presence
Citation counts
Time-series comparison data
This allows you to:
Track share of AI visibility
Benchmark against competitors
Visualize competitive movement over time
3. Topic-level performance
You can segment performance by topic.
The API returns:
Visibility trends per topic
Sentiment per topic
Mentions and citations per topic
Time-series breakdowns
This is useful for:
Product-line reporting
Use-case segmentation
Content cluster analysis
4. Engine-level breakdowns
Performance can be segmented by AI engine, such as:
ChatGPT
Google AI Overviews
Perplexity
Others configured in your project
You can analyze:
Engine-specific visibility
Sentiment by engine
Detection rate by engine
Historical trends per engine
This helps identify:
Platform-specific strengths
Model-level visibility gaps
Optimization priorities
5. Sentiment analytics
The API provides detailed sentiment analysis data, including:
Brand sentiment aggregates
Company sentiment aggregates
Positive / Neutral / Negative keyword breakdowns
Sentiment counts
Sentiment by AI engine
Sentiment by search term
This allows you to:
Monitor brand perception in AI systems
Track reputation shifts
Analyze sentiment-driving keywords
Compare competitor sentiment
6. Citation analytics
The citation endpoint provides detailed citation insights, including:
Domain-level citation aggregates
URL-level citation aggregates
Citation breakdown by AI engine
Citation breakdown by query
Brand citation performance
Competitor citation comparisons
This is useful for:
Authority analysis
Identifying frequently cited domains
Measuring AI trust signals
Monitoring competitive citation share
Filtering & time controls
The API allows you to control how metrics are retrieved.
You can define:
Timeframe (e.g., 30d, 1y)
Aggregation level (hourly, daily, weekly, monthly)
Period offsets (current vs previous period)
Specific topics
Specific search terms
Specific AI engines
This makes it possible to:
Compare current vs previous periods
Power trend graphs
Build rolling performance dashboards
What the API does not provide
The API does not return:
Full raw AI-generated answer text
Individual execution transcripts
Spyglass-style result snapshots
It focuses on reporting-level, aggregated analytics data.
If you need execution-level inspection, use the platform UI.
When to use the API
Use the API when:
You need automated reporting
You want to integrate AI visibility into your product
You’re building custom dashboards
You need cross-channel analytics
You want to store historical AI performance data
If you only need:
Occasional reports → use dashboard sharing
Spreadsheet analysis → use CSV exports
BI dashboards without engineering → use the Looker Studio connector
The API is for advanced and scalable use cases.
Best practices
1. Store historical data externally
Maintain long-term AI visibility trends in your warehouse.
2. Separate engine reporting
Build dashboards that compare engine-level performance.
3. Monitor detection rate + visibility together
Visibility without detection frequency can be misleading.
4. Use period offsets for growth tracking
Compare current vs previous period to measure improvement.
5. Combine AI Visibility with SEO data
Unify SERP tracking and AI visibility for a complete search strategy.