---
title: "Create Insight"
method: POST
path: "/api/search-insights"
tags: ["Search Insights"]
---

# Create Insight

`POST /api/search-insights`

## 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/search-insights`
- Auth: HTTP bearer

## Headers

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

## Request body

- CreateInsightRequest
  - `keyword` string, required
  - `intent` string, nullable: Optional explicit intent. When omitted, the classifier decides. Valid values: kol_discovery, content_inspiration, competitive_research, trend_research, unclassified
  - `context` string, nullable
  - `source_job_id` string, nullable

## Response `202`

Successful Response

- CreateInsightResponse
  - `insight_id` string, required
  - `status` string, required
  - `intent` string, required
  - `keyword` string, required
  - `cached` boolean

## 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)