public-api

Run Diagnose Api

Start a new diagnosis for a search query.

Queries AI models to analyze why your brand does or doesn't appear for this query, then provides recommendations. Poll GET /diagnose?diagnosis_id=X for results.

Subject to monthly usage limits based on your plan.

post/diagnose

Request

  • Base URL: https://api.trakkr.ai
  • URL: https://api.trakkr.ai/diagnose
  • Auth: HTTP bearer

Request body

brand_idstring uuid required
querystring required

The search query to diagnose

market_idstring nullable

Exact brand market id. Null selects Global.

idempotency_keystring nullable

Stable key for retries, including after completion. If omitted, identical requests reuse an active run and start a new run after it finishes.

Response

Successful Response

diagnosis_idstring required
statusstring
messagestring
outcome'admitted' | 'existing'
market_idstring nullable
market_scope'exact' | 'global'

Changes

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