# semrush.seo.keywords.volume.batch

Volume, CPC and competition of up to 100 keywords by country

> This report provides a summary of up to 100 keywords, including their volume, CPC, competition level, and the number of results in a chosen regional database.

Page: https://telipot.com/catalog/tasks/semrush.seo.keywords.volume.batch · Markdown: https://telipot.com/catalog/tasks/semrush.seo.keywords.volume.batch/md · JSON: https://telipot.com/catalog/tasks/semrush.seo.keywords.volume.batch/json

| Field | Value |
| --- | --- |
| provider | [Semrush](https://telipot.com/catalog/providers/semrush) `semrush` |
| capability | [`seo.keywords.volume.batch`](https://telipot.com/catalog/capabilities/seo.keywords.volume.batch) |
| kind | data |
| tier | core |
| price | Semrush API units (10 API units / result · docs) |
| price note | 10 API units per line returned, one line per keyword found. Semrush does not charge a request that returns no data. Semrush publishes no USD price per API unit. |
| identity | Your plan |
| auth | `api_key · in query as key` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `GET https://api.semrush.com/` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://developer.semrush.com/api/v3/seo/keyword-reports/#batch-keyword-overview-one-database |

## Preview the price · nothing runs

```bash
telipot run semrush.seo.keywords.volume.batch \
  --input-json '{"type":"phrase_these","phrase":"seo;ebay","database":"us","export_columns":"Ph,Nq,Cp,Co"}' \
  --quote
```

## Run it

```bash
telipot run semrush.seo.keywords.volume.batch \
  --input-json '{"type":"phrase_these","phrase":"seo;ebay","database":"us","export_columns":"Ph,Nq,Cp,Co"}'
```

```bash
curl https://api.telipot.com/v1/tasks/semrush.seo.keywords.volume.batch/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"phrase_these","phrase":"seo;ebay","database":"us","export_columns":"Ph,Nq,Cp,Co"}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `type` | queryParams | string | yes | const "phrase_these" | Fixed. Selects the Batch Keyword Overview (one database) report. |
| `phrase` | queryParams | string | yes |  | Up to 100 keywords or keyword expressions separated by semicolons. |
| `database` | queryParams | string | yes |  | Two-letter regional database code, such as us, uk, ca, de or fr. Keyword reports accept the plain two-letter codes only, not the mobile- and -ext variants. The full list is under Databases in the SEO API overview. |
| `export_columns` | queryParams | string | no | default "Ph,Nq,Cp,Co,Nr,Td" | Comma-separated column codes, in the order wanted. Ph Keyword, Nq Search Volume (monthly average over the last 12 months), Cp CPC in USD, Co Competition (0 to 1, 1 is highest), Nr Number of Results, Td Trends (12 monthly values), In Intents (0 Commercial, 1 Informational, 2 Navigational, 3 Transactional), Kd Keyword Difficulty Index (0 to 100, higher is harder). |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Fixed. Selects the Batch Keyword Overview (one database) report.",
      "const": "phrase_these"
    },
    "phrase": {
      "type": "string",
      "description": "Up to 100 keywords or keyword expressions separated by semicolons.",
      "examples": [
        "seo;ebay"
      ]
    },
    "database": {
      "type": "string",
      "description": "Two-letter regional database code, such as us, uk, ca, de or fr. Keyword reports accept the plain two-letter codes only, not the mobile- and -ext variants. The full list is under Databases in the SEO API overview.",
      "examples": [
        "us"
      ]
    },
    "export_columns": {
      "type": "string",
      "description": "Comma-separated column codes, in the order wanted. Ph Keyword, Nq Search Volume (monthly average over the last 12 months), Cp CPC in USD, Co Competition (0 to 1, 1 is highest), Nr Number of Results, Td Trends (12 monthly values), In Intents (0 Commercial, 1 Informational, 2 Navigational, 3 Transactional), Kd Keyword Difficulty Index (0 to 100, higher is harder).",
      "default": "Ph,Nq,Cp,Co,Nr,Td"
    }
  },
  "required": [
    "type",
    "phrase",
    "database"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "string",
  "pattern": "^(?!\\s*ERROR)",
  "description": "CSV text: a header line of column names, then one line per keyword, columns separated by semicolons, in the order of export_columns. A body that starts with ERROR is a failure, for example ERROR 50 :: NOTHING FOUND."
}
```