public-api

Get Perception

Get perception data for a brand.

Views:

  • dashboard (default): full perception dashboard — scores, time series, competitor gaps, radar chart data
  • metrics: raw metric_history rows (optionally filter by tracked_brand)
  • narrative: latest positioning summary — strengths, weaknesses, opportunities
  • story: weekly story / narrative arc payload that drives the Story tab
  • narrative_drift: how the brand's narrative has shifted over weeks weeks (used by the Goals tab)

Requires a paid plan.

get/get-perception

Request

  • Base URL: https://api.trakkr.ai
  • URL: https://api.trakkr.ai/get-perception
  • Auth: HTTP bearer

Query parameters

brand_idstring uuid required

Brand UUID

view'dashboard' | 'metrics' | 'narrative' | 'story' | 'narrative_drift'

View type: dashboard, metrics, narrative, story, or narrative_drift

daysinteger

Number of days of data (dashboard/metrics views)

weeksinteger

Number of weeks for narrative_drift view

tracked_brandstring nullable

Filter by specific tracked brand (metrics view only)

periodstring nullable

A frozen calendar period instead of a rolling window: a month as YYYY-MM (2026-08) or a quarter as YYYY-Qn (2026-Q3). A closed month is read from the archive frozen when it closed; the open month is computed to date. When period is given, days is ignored and the response carries a period block saying exactly what was resolved. Definitions: /get-metrics.

Response

Successful Response

OR
OR
OR
OR
object required
OR
OR
OR
OR
OR
OR
object required

Example response

{
  "story": {
    "run_date": "2026-10-07",
    "total_prompts_analyzed": 12,
    "total_responses_processed": 48,
    "narrative": {
      "positioning": "A sample workspace for team notes and projects.",
      "key_themes": []
    },
    "perception_score": 42,
    "perception_percentile": 80,
    "perception_change_7d": 1.5,
    "semantic_dna": {
      "semantic_dna": [],
      "primary_descriptors": [],
      "emerging_descriptors": [],
      "fading_descriptors": []
    },
    "use_case_mapping": {
      "winning_use_cases": [],
      "losing_use_cases": []
    },
    "perception_gaps": {
      "perception_gaps": []
    },
    "common_concerns": [],
    "recommendations": [],
    "top_cited_domains": [],
    "source_perception_map": []
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.