Skip to content
TrakkrAPI

Perception

Access AI perception data - understand how AI models perceive your brand across trust, quality, value, market position, and innovation.

Requires authentication
60 req/min

Overview

The Perception API provides access to how AI models (GPT-4o, Claude, Gemini, Perplexity) perceive your brand across 20 metrics grouped into 5 categories: Trust & Reliability, Quality & Performance, Value & Experience, Market Position, and Innovation & Appeal.

The dashboard view returns the same rich data powering the Perception page in the Trakkr app.

Get Dashboard

GET/get-perceptionReturns full perception dashboard: scores, time series, competitor gaps, and radar data.

Query Parameters

brand_idstringrequired

The brand ID to get perception data for

viewstring

View type: "dashboard" (default), "metrics", or "narrative"

Default: dashboard

daysinteger

Number of days of data to return (7-365)

Default: 90

tracked_brandstring

Filter by specific tracked brand (metrics view only)

Dashboard Response

Dashboard Schema

metadataobject

Query metadata including brand info and date range

perception_scoreobject

Overall perception score with 7-day change and percentile

category_scoresobject

Scores for 5 categories: trust_reliability, quality_performance, value_experience, market_position, innovation_appeal

insightsobject

Strengths and opportunities identified from the data

brand_summariesarray

Summary for each tracked brand showing metric rankings

detailed_sentiment_timeseriesarray

Full time series for all 20 metrics per brand

competitor_gapsarray

Gap analysis showing advantages and disadvantages vs each competitor

radar_chart_dataarray

Radar chart data points for each tracked brand

metric_rankingsobject

Rankings for each metric across all tracked brands

primary_brand_overall_timeseriesarray

Overall score time series for the primary brand

Get Raw Metrics

Use view=metrics to get raw metric history data points. Each row contains all 20 metric scores for a specific tracked brand on a specific date. Useful for building custom charts.

Metrics View
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-perception?brand_id=YOUR_BRAND_ID&view=metrics&days=30'

Get Narrative

Use view=narrative to get a high-level positioning summary: how AI models describe your brand, key strengths, weaknesses, emerging opportunities, and overall sentiment.

Narrative View
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-perception?brand_id=YOUR_BRAND_ID&view=narrative'
200 OK
1{
2  "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
3  "narrative": {
4    "positioning": "Notion is consistently positioned as an all-in-one workspace that combines notes, docs, and project management. AI models describe it as a flexible productivity tool favored by teams and individuals.",
5    "strengths": [
6      "All-in-one workspace",
7      "Flexible and customizable",
8      "Strong template ecosystem",
9      "AI-powered features",
10      "Team collaboration"
11    ],
12    "weaknesses": [
13      "Performance concerns",
14      "Steep learning curve"
15    ],
16    "opportunities": [
17      "AI integration leadership",
18      "Enterprise adoption",
19      "Offline capabilities"
20    ],
21    "sentiment_summary": "Positive and authoritative. AI models frame Notion as a market leader in the productivity space with strong brand recognition."
22  },
23  "snapshot_date": "2026-03-20T14:30:00Z"
24}

Trigger Analysis

POST/get-perceptionTrigger a new perception analysis. Queries 4 AI models to evaluate your brand.

Body Parameters

brand_idstringrequired

The brand ID to analyze

include_competitorsboolean

Also analyze competitor brands

Default: true

Analysis queries 4 AI models and takes 30-60 seconds to complete. Rate limited to 10 requests per minute. After triggering, use the GET endpoint to fetch updated data.
Trigger Analysis
1curl -X POST 'https://api.trakkr.ai/get-perception' \
2  -H 'Authorization: Bearer $TRAKKR_API_KEY' \
3  -H 'Content-Type: application/json' \
4  -d '{
5    "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
6    "include_competitors": true
7  }'
200 OK
1{
2  "status": "success",
3  "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4  "primary_brand": "Notion",
5  "run_date": "2026-03-07",
6  "brands_analyzed": ["Notion", "Coda", "Confluence", "Monday.com"],
7  "error": null
8}

The 20 Metrics

Each perception analysis evaluates 20 metrics on a 0-100 scale:

Trust & Reliability

overall_trust, reliability_score, transparency_level, safety_perception

Quality & Performance

overall_quality, problem_resolution, responsiveness, user_satisfaction

Value & Experience

value_for_money, ease_of_interaction, accessibility, necessity_level

Market Position

brand_recognition, professional_image, recommendation_likelihood, uniqueness

Innovation & Appeal

forward_thinking, adaptability, likability, confidence_inspiring

Quick Reference

EndpointDescriptionRate Limit
GET/get-perception
Dashboard, metrics, or narrative data60/min
POST/get-perception
Trigger new analysis10/min

Code Example

Dashboard View
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-perception?brand_id=YOUR_BRAND_ID&view=dashboard&days=90'
200 OK
1{
2  "metadata": {
3    "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4    "primary_brand": "Notion",
5    "date_range_start": "2025-12-01",
6    "date_range_end": "2026-03-01",
7    "total_brands_tracked": 4,
8    "days_of_data": 90
9  },
10  "perception_score": {
11    "score": 72.5,
12    "change_7d": 1.3,
13    "percentile": 82.0
14  },
15  "category_scores": {
16    "trust_reliability": 78.2,
17    "quality_performance": 71.0,
18    "value_experience": 68.5,
19    "market_position": 75.3,
20    "innovation_appeal": 69.8
21  },
22  "insights": {
23    "strengths": ["High trust scores across all models", "Strong brand recognition"],
24    "opportunities": ["Improve value perception", "Increase adaptability messaging"]
25  },
26  "brand_summaries": [
27    {
28      "brand_name": "Notion",
29      "is_primary": true,
30      "rank_1_in": ["overall_quality", "ease_of_interaction"],
31      "rank_last_in": []
32    }
33  ],
34  "competitor_gaps": [
35    {
36      "competitor": "Coda",
37      "your_advantages": ["overall_trust", "brand_recognition"],
38      "their_advantages": ["value_for_money"],
39      "biggest_gap_for_you": "value_for_money",
40      "biggest_gap_against_you": null
41    }
42  ],
43  "primary_brand_overall_timeseries": [
44    {"date": "2026-02-01", "score": 71.2},
45    {"date": "2026-02-08", "score": 72.5}
46  ]
47}
Press ? for keyboard shortcuts