---
title: "Analyze Topic"
method: POST
path: "/api/v1/ai/topic-radar/insight"
tags: ["ai-topic-radar"]
---

# Analyze Topic

`POST /api/v1/ai/topic-radar/insight`

## Request

- Base URL: `https://useaistation.com` (the document declares no server; this is the origin it was published from)
- URL: `https://useaistation.com/api/v1/ai/topic-radar/insight`
- Auth: none declared

## Query parameters

- `locale` string

## Request body

- TopicIdRequest
  - `topic_id` string, required

## Response `200`

Successful Response

- TopicInsightResponse
  - `topic_id` string, required
  - `cached` boolean, required
  - `generated_at` string, required
  - `verdict` string, required
  - `can_make_short_video` 'yes' | 'conditional' | 'no', required
  - `content_readiness` 'ready_for_research' | 'needs_more_signals' | 'not_suitable', required
  - `editorial_stage` 'current_hot_candidate' | 'early_opportunity' | 'watch_only', required
  - `recommended_format` string, required
  - `target_audience` string[], required
  - `audience_payoff` string, required
  - `why_now` string[]
  - `why_this_can_work` string[], required
  - `attention_points` string[], required
  - `recommended_angle_index` integer
  - `angles` TopicContentAngle[], required
    - `title` string, required
    - `hook` string, required
    - `format` string, required
    - `angle_type` string, required
    - `viewer_question` string, required
    - `core_conflict` string, required
    - `promise` string, required
    - `narrative_beats` string[], required
    - `opening_3_seconds` string, required
    - `visual_moments` string[], required
    - `platform_fit` string[], required
    - `research_questions` string[], required
    - `search_queries` string[], required
    - `preferred_source_types` string[], required
    - `must_verify` string[], required
    - `avoid_claims` string[], required
    - `fact_basis` string[]
    - `unsupported_assumptions` string[]
  - `short_video_handoff` TopicShortVideoHandoff, required
    - `topic_id` string
    - `working_title` string, required
    - `one_line_pitch` string, required
    - `selected_angle` string, required
    - `research_goal` string, required
    - `research_questions` string[], required
    - `search_queries` string[], required
    - `preferred_source_types` string[], required
    - `must_verify` string[], required
    - `known_unknowns` string[]
    - `target_audience` string[], required
    - `suggested_duration_sec` integer
    - `tone` string, required
    - `visual_material_needs` string[], required
    - `script_skeleton` string[], required
    - `growth_hypothesis` string, required
  - `watchouts` string[]
  - `generation_quality` 'complete' | 'degraded'
  - `score_breakdown` TopicScoreBreakdown
    - `freshness` integer
    - `velocity` integer
    - `independent_sources` integer
    - `cross_region` integer
    - `absolute_heat` integer
    - `evidence` integer
    - `trend` integer
    - `editorial` integer
    - `confidence` integer
    - `market_fit` integer
    - `methodology` string
  - `provider` string
  - `model` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/useaistation/apis/akaiagents-ai-workstation-api.md) · [All operations](https://skmtc.dev/useaistation/apis/akaiagents-ai-workstation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useaistation/apis/akaiagents-ai-workstation-api/revisions/829070f6ff15?raw)