Write

Generate an AI competitive insight (7-day cooldown)

Runs an AI analysis over the landscape: clusters keyword gaps into named opportunity themes with per-keyword metrics, writes threat narratives for climbing competitors, and diffs against the previous analysis. At most one analysis per app per 7 days — 429 with code cooldown and the next available time while in cooldown. 403 trial_locked on trial plans (AI-cost feature, paid plans only; GET stays available), 422 no_competitors / too_little_data (fewer than 5 compared keywords), 502 ai_failed. Requires a paid (non-trial) Indie plan and a write-scope API key.

post/api/v1/apps/{id}/competitor-landscape

Request

  • Base URL: https://api.trysonar.app
  • URL: https://api.trysonar.app/api/v1/apps/{id}/competitor-landscape
  • Auth: HTTP bearer

Path parameters

idstring required

Your own app's Sonar UUID

Request body

object required

Response

{ app_id, insight } — same insight shape as the GET endpoint

dataobject required

Result payload — full field reference at https://trysonar.app/docs/api

Changes

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