---
title: "Generate podcast ideas (public, origin-restricted)"
method: POST
path: "/podcast/ideas"
tags: ["Podcast"]
---

# Generate podcast ideas (public, origin-restricted)

`POST /podcast/ideas`

Returns 3–8 podcast ideas. Each idea includes a podcast name, description,
exactly four episode titles, and AI-estimated 0–100 scores for questionComplexity,
topicalDepth, searchVolumeConversational, and contentFreshness.
No JWT required, but the request must come from an allowlisted Origin
(autocontentapi.com / app.autocontentapi.com / localhost) OR carry a valid
`X-Free-Tools-Secret` header (used by the Next.js proxy). Other callers
receive 403. Limits: 2 requests per IP per 24h, 30 total per 24h,
2 concurrent per IP.

## Request body

- object
  - `topic` string, nullable — Optional topic to tailor podcast ideas. If omitted or null, the AI will propose topics.

## Response `200`

Structured list of podcast ideas

- object
  - `success` boolean
  - `requestId` string
  - `ideas` object[]
    - `name` string
    - `description` string
    - `episodes` string[]
    - `stats` object
      - `questionComplexity` integer
      - `topicalDepth` integer
      - `searchVolumeConversational` integer
      - `contentFreshness` integer

## Other responses

- `429` — Rate limit exceeded (10/day) or too many concurrent requests (2/IP)
- `500` — Internal server error

---

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