---
title: "Duplicate a keyword"
description: "Creates a new keyword from this one's settings under a new `term`, or the same term in another group: its kind, platforms, context, every matching rule, its monthly mention cap and its comments setting. Review pages and feeds are copied only when named in `include`. The copy is a new keyword: $5 a month, and the newest posts of the last 30 days come in at once, as for any new keyword."
canonical: https://docs.rumoro.dev/api/keywords/duplicate-keyword
markdown: https://docs.rumoro.dev/api/keywords/duplicate-keyword.mdx
---

# Duplicate a keyword

`POST /v1/keywords/{id}/duplicate`

Creates a new keyword from this one's settings under a new `term`, or the same term in another group: its kind, platforms, context, every matching rule, its monthly mention cap and its comments setting. Review pages and feeds are copied only when named in `include`. The copy is a new keyword: $5 a month, and the newest posts of the last 30 days come in at once, as for any new keyword.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | Keyword id (kw_...). |

## Body

| Field | Required | Description |
| --- | --- | --- |
| `term` | yes | The copy's term. The original's term is allowed only in another group (groupId), since a group tracks a term once. |
| `groupId` |  | The copy's group (grp_...). Omitted, it joins the original's group. |
| `include` |  | Also copy these: reviewSources (its review pages) and feeds (its RSS or Atom feeds). Off by default, because two keywords on one page or feed collect, and bill, every review or item twice. |

## Responses

| Status | Meaning |
| --- | --- |
| 201 | The new keyword |
| 401 | Missing or invalid API key |
| 402 | Not enough balance for one more keyword-day (insufficient_balance), or the 500-keyword ceiling is reached (keyword_limit_reached) |
| 404 | Keyword not found |
| 409 | The group already tracks this term |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).