{
  "url": "https://telipot.com/catalog/tasks/semrush.seo.keywords.volume.batch",
  "id": "semrush.seo.keywords.volume.batch",
  "name": "Volume, CPC and competition of up to 100 keywords by country",
  "provider": {
    "slug": "semrush",
    "name": "Semrush"
  },
  "capability": "seo.keywords.volume.batch",
  "platform": "seo",
  "kind": "data",
  "tier": "core",
  "identity": "key",
  "identityLabel": "Your plan",
  "price": {
    "native": {
      "text": "10 API units per result",
      "figure": "10 API units",
      "per": "result",
      "currency": "API units"
    },
    "confidence": "documented",
    "source": "docs",
    "sourceUrl": "https://developer.semrush.com/api/v3/seo/keyword-reports/#batch-keyword-overview-one-database",
    "checked": "2026-10-05",
    "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.",
    "type": "per_result",
    "state": "native",
    "label": "Semrush API units",
    "detail": "10 API units / result · docs"
  },
  "providers": 1,
  "retention": "standard",
  "runsOn": "byoc",
  "live": true,
  "summary": "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.",
  "method": "GET",
  "path": "/",
  "host": "https://api.semrush.com",
  "docsUrl": "https://developer.semrush.com/api/v3/seo/keyword-reports/#batch-keyword-overview-one-database",
  "auth": {
    "scheme": "api_key",
    "label": "api_key · in query as key",
    "short": "api_key · ?key"
  },
  "scope": "any_account",
  "principal": "organization",
  "requiredScopes": [],
  "verification": {
    "state": "none",
    "label": "Not verified yet",
    "detail": "Not checked yet. We test with a real request before we mark it."
  },
  "input": [
    {
      "name": "type",
      "location": "queryParams",
      "type": "string",
      "required": true,
      "constraints": [
        "const \"phrase_these\""
      ],
      "note": "Fixed. Selects the Batch Keyword Overview (one database) report."
    },
    {
      "name": "phrase",
      "location": "queryParams",
      "type": "string",
      "required": true,
      "constraints": [],
      "note": "Up to 100 keywords or keyword expressions separated by semicolons."
    },
    {
      "name": "database",
      "location": "queryParams",
      "type": "string",
      "required": true,
      "constraints": [],
      "note": "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."
    },
    {
      "name": "export_columns",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [
        "default \"Ph,Nq,Cp,Co,Nr,Td\""
      ],
      "note": "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)."
    }
  ],
  "sampleInput": {
    "type": "phrase_these",
    "phrase": "seo;ebay",
    "database": "us",
    "export_columns": "Ph,Nq,Cp,Co"
  },
  "inputSchema": {
    "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": [
    {
      "name": "output",
      "type": "string",
      "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."
    }
  ],
  "outputSchema": {
    "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."
  },
  "commands": {
    "mode": "run",
    "cli": "telipot run semrush.seo.keywords.volume.batch \\\n  --input-json '{\"type\":\"phrase_these\",\"phrase\":\"seo;ebay\",\"database\":\"us\",\"export_columns\":\"Ph,Nq,Cp,Co\"}'",
    "http": "curl https://api.telipot.com/v1/tasks/semrush.seo.keywords.volume.batch/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"type\":\"phrase_these\",\"phrase\":\"seo;ebay\",\"database\":\"us\",\"export_columns\":\"Ph,Nq,Cp,Co\"}'",
    "quote": "telipot run semrush.seo.keywords.volume.batch \\\n  --input-json '{\"type\":\"phrase_these\",\"phrase\":\"seo;ebay\",\"database\":\"us\",\"export_columns\":\"Ph,Nq,Cp,Co\"}' \\\n  --quote"
  },
  "siblings": []
}