---
title: "Use AI Copywriter for the niche"
method: POST
path: "/v1/niches/{nicheId}/ai-copywriter"
tags: ["v1"]
---

# Use AI Copywriter for the niche

`POST /v1/niches/{nicheId}/ai-copywriter`

Starts an advanced-AI listing generation for the Niche and returns immediately with a `generationId`. Generation runs asynchronously — poll GET /v1/niches/:nicheId/ai-copywriter/:generationId until `status` is `complete` (result available) or `failed`.

## Path parameters

- `nicheId` string, required

## Request body

- AiCopyWriterInputDto
  - `prompt` 'cosmo' | 'ranking-juice' | 'nlp' | 'cosmo-rufus', required
  - `listingToInclude` object, required

## Other responses

- `401` — Api key is invalid
- `403` — AI Copywriter prompt quota exceeded (`error: "QUOTA_EXCEEDED"`), or no access to the niche
- `404` — Resource not found
- `429` — Rate limit exceeded (2 requests/min per API key).
- `500` — Internal error

## Changes

- **2026-09-15** `83202c6c6458` — 1 warning
  - added the new `REVIEW_REQUEST_ASINS` enum value to the `feature` response property for the response status `403`
- **2026-09-08** `0e41255f2949` — 1 info
  - added the media type `application/json` for the response with the status `403`

[Change history](https://skmtc.dev/datadive/apis/data-dive-developer-apis/changes/v1/niches/:nicheId/ai-copywriter/post.md)

---

[API](https://skmtc.dev/datadive/apis/data-dive-developer-apis.md) · [All operations](https://skmtc.dev/datadive/apis/data-dive-developer-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/datadive/apis/data-dive-developer-apis/revisions/6fe0b8ec046c?raw)