Keyword clusters

Groups the keywords from a keyword-ideas job into topic clusters, so you can plan content pillars. Clustering runs as an asynchronous job.

Create a clustering run

POST/keywords/clusters

Body parameters

Parameter	Type	Description
`job_id`required	string	The keyword-ideas job whose keywords should be clustered.
`method`	string	`serp` (group by overlapping ranking URLs) or `semantic` (group by meaning). Defaults to `serp`.

cURL

curl -X POST "https://api.oneclickseo.ai/v1/keywords/clusters" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "job_id": "job_3f9a2c", "method": "serp" }'

Fetch clusters

GET/keywords/clusters/{run_id}

200Completed clustering run

Response

{
  "data": {
    "id": "run_7b1e90",
    "method": "serp",
    "status": "completed",
    "cluster_count": 38,
    "keyword_count": 1842,
    "clusters": [
      {
        "label": "link building services",
        "total_volume": 18400,
        "keyword_count": 26,
        "members": [
          { "keyword": "link building services", "volume": 2400, "difficulty": 61 }
        ]
      }
    ]
  },
  "meta": { "request_id": "req_8f2c1a", "credits_charged": 1 }
}

Cluster fields

Parameter	Type	Description
`label`	string	The cluster's representative topic.
`total_volume`	integer	Sum of member keyword volumes.
`keyword_count`	integer	Number of keywords in the cluster.
`members`	object[]	Member keywords with their metrics.