---
title: "Get Kol Deep Overview Cached"
method: GET
path: "/api/kols/{username}/deep-overview"
tags: ["KOL Database"]
---

# Get Kol Deep Overview Cached

`GET /api/kols/{username}/deep-overview`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/kols/{username}/deep-overview`
- Auth: HTTP bearer

Cache-only read for the deep analysis. Returns ``null`` (HTTP 200)
when there's nothing cached — the dossier card uses that to flip its
button from "View deep analysis" to "Run deep analysis (2 credits)".

Never charges. The POST counterpart at the same path runs the
analysis and bills the workspace / personal credit pool.

## Path parameters

- `username` string, required

## Query parameters

- `locale` string: Output locale — en / zh-CN / ja

## Headers

- `x-kolens-user-id` string, nullable
- `x-kolens-workspace-id` string, nullable

## Response `200`

Successful Response

- DeepOverviewResponse: Strict superset of OverviewSummaryResponse — five extra paragraph- level sections that justify the deep tier's paid price point.
  - `overall_summary` string, required
  - `content_themes` string[], required
  - `audience_signal` string, required
  - `partnership_signals` string[], required
  - `red_flags` string[], required
  - `fit_for` string[], required
  - `recommendation_score` integer, nullable
  - `content_fit_score` integer, nullable
  - `audience_fit_score` integer, nullable
  - `risk_score` integer, nullable
  - `score_rationale` string, nullable
  - `brand_profile_status` string
  - `workspace_slug` string, nullable
  - `content_quality` string
  - `partnership_history` string
  - `outreach_strategy` string[]
  - `negotiation_notes` string
  - `competitive_context` string
  - `generated_at` string, required
  - `videos_analyzed` integer, required
  - `cost_credits` integer, required
  - `model_used` string, nullable
  - `cached` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)