public-api

Get Actions Public

List committed actions and saved recommendations for a brand.

Open/active/pending reads also return suggestions awaiting a decision, filtered by the same quick-win/category/source/type/lens/search/URL criteria. Suggestions use their own IDs, total, and pagination; review or accept via commit_opportunity, never manage_action. Historical reads exclude them.

This is the canonical "what should the brand do" surface — every signal in Trakkr (audit, crawler, prompts, citations, competitors, traffic, reddit, diagnose) gets synthesized into this queue with title, description, detail, first_step, effort, impact, priority_score, action_data (the raw supporting evidence), and a deep_link. Actions that carry them also return family, page_id, page_url, and result (the measured before/after outcome). The deprecated proof alias remains for existing integrations.

For an "AI search technical audit" view, filter: source=site_audit,crawler_monitoring AND category=technical

Read-only. Synthesis runs server-side on a cooldown; this endpoint never triggers generation.

get/get-actions

Request

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

Query parameters

brand_idstring uuid required

Brand UUID

statusstring nullable

Filter by action status. Use 'open' (default) for the live queue (pending + in_progress + snoozed), 'active' to include completed, or pass a single literal: pending, in_progress, completed, dismissed, snoozed.

categorystring nullable

Comma-separated categories: content, technical, competitive, optimization, citation, setup, reddit, diagnose.

action_typestring nullable

Filter to a single action_type (e.g. 'add_llms_txt')

sourcestring nullable

Filter by source: site_audit, crawler_monitoring, prompt_monitoring, citation_monitoring, diagnose, competitor_tracking, content_ideas, traffic_analytics, reddit, setup, manual, ai_synthesizer.

lensstring nullable

Optional product-lens filter (e.g. 'crawler' for crawler-tab view).

quick_winboolean nullable

If true, only return high-impact / low-effort actions.

searchstring nullable

Text search across title, description, source, action_type.

urlstring nullable

Filter to actions scoped to this URL or path.

sort_bystring

priority_score | created_at | updated_at

sort_dirstring

asc or desc

limitinteger

Results per page

offsetinteger

Pagination offset

Response

Successful Response

suggestion_totalinteger
notestring nullable

Changes

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