---
title: "Get video topic ideas for a niche"
method: POST
path: "/ideas"
tags: ["Tools"]
---

# Get video topic ideas for a niche

`POST /ideas`

Generates a list of specific, viral-style video topic ideas for a niche or audience. Use an idea as the `script` in `POST /videos/generate` with `inputType: "idea"`, or expand it first with `POST /scripts`.

**Cost:** 2 credits per call.

## Request body

- object
  - `prompt` string, required — The niche, audience, or theme to brainstorm for. Example: "space facts for a faceless YouTube Shorts channel".
  - `language` string — Language for the ideas (ISO 639-1 code like "en", "es", "hi"). Default: "en".
  - `count` number — How many ideas to generate (5-15). Default: 10.
  - `source` 'tool_page' | 'inline' — Where the request came from, for analytics only. Dashboard use; safe to omit.
  - `templateId` string — Creation template the request came from, for analytics only. Dashboard use; safe to omit.

## Response `200`

OK

- object
  - `ideas` string[], required — Video topic ideas, one per entry.
  - `creditsUsed` number, required — Credits deducted for this generation.

## Other responses

- `401` — 401
- `402` — 402
- `403` — 403

---

[API](https://skmtc.net/aituber/apis/aituber-api.md) · [All operations](https://skmtc.net/aituber/apis/aituber-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aituber/aituber-api/revisions/35448566f143/schema)