---
title: "Get a keyword"
description: "Returns one keyword with its matching rules, review pages, this month's cost and the polling status on each platform."
canonical: https://docs.rumoro.dev/api/keywords/get-keyword
markdown: https://docs.rumoro.dev/api/keywords/get-keyword.mdx
---

# Get a keyword

`GET /v1/keywords/{id}`

Returns one keyword with its matching rules, review pages, this month's cost and the polling status on each platform.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The keyword's id (kw_...). |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The requested keyword |
| 401 | The API key is missing or not valid |
| 404 | No keyword with this id |

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