# Keyword programs: measure

URL: /code/mcp/keyword/verbs · Id: `page:code/mcp/keyword/verbs`

> The Keyword Verbs measure as MCP do programs, with inputs, result, refusals and an example.

Reference for [Keyword](/business/nouns/keyword), one group of [Keyword programs](/code/mcp/keyword).

### Keyword.measure
Measure records a Keyword’s monthly search volume, difficulty, cost per click and trend in one locale. [Verb page](/business/nouns/keyword/measure?interface=mcp).

```text
do: return await $.Keyword.measure(input)
```

Emits [`Keyword.measured`](/business/events/Keyword.measured).

**Inputs**

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `keyword` | [Keyword](/business/nouns/keyword) | Yes | The Keyword to measure. |
| `locale` | `string` | No | The market and language, such as `en-US`. Defaults to the Startup’s home Market. |
| `venue` | `string` | No | The search venue, such as `google-search`. Defaults to the largest one in the Market. |

**Returns**

| Output | Type | Required | Description |
| --- | --- | --- | --- |
| `keyword` | [Keyword](/business/nouns/keyword) | Yes | The Keyword; each measure is a `Keyword.measured` Event with its method and observation time. |

**Refuses when**

| Check | Error | Fix | Then call |
| --- | --- | --- | --- |
| The key is valid, but its scopes do not allow this operation. | [`forbidden`](/code/api/errors/forbidden) | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |

**Example**

```json
{
  "name": "do",
  "arguments": {
    "code": "return await $.Keyword.measure({ keyword: 'keyword_cEoeFM4Drs' })"
  }
}
```