apyhub
Back
▣ MARKETING · SEO

Generate Keyword Clusters API

What it does

Keyword Clusters takes an article URL and groups the article's terms into topical clusters. Send a URL, and you get back the source URL, a primary_topic, an array of clusters, and a related_keywords list.

Use the clusters to see which themes dominate a page without manually reading through every mention. Each cluster includes a topic label and the keywords grouped under it, which makes it easier to map content to search intent, build topic briefs, or identify gaps in an article set.

Keyword Clusters is a fit for SEO workflows, content analysis, and editorial research. If you're auditing a page, planning internal links, or comparing how one article covers a subject versus another, the response gives you a compact structured summary you can feed into downstream tools.

Because the input is just a URL, it is easy to slot into crawlers, content pipelines, and CMS enrichment jobs. The output stays focused on topic-level grouping, so you can use it as-is or combine it with your own ranking, tagging, or reporting logic.

GET
Generate keyword clusters from an article
https://api.eu.apyhub.com/namastesumalya/generate-keyword-clusters

QUICKSTART

GUIDE

Quickstart

Fetch keyword clusters for an article URL by passing the required url as a query parameter.

curl -X GET "https://api.eu.apyhub.com/namastesumalya/generate-keyword-clusters?url=https://example.com/article" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with url as a string, clusters as an array of objects, primary_topic as a string, and related_keywords as an array of strings.

{
  "url": "https://example.com/article",
  "clusters": [
    {
      "topic": "AI Tools",
      "keywords": ["ChatGPT", "automation tools"]
    }
  ],
  "primary_topic": "Artificial Intelligence",
  "related_keywords": ["AI automation", "machine learning", "content generation"]
}
TRY ITLIVE · 600 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Generates keyword clusters for an article identified by its URL. The response returns the article URL plus grouped keyword themes, a primary topic, and a list of related keywords.

Query Parameter(s)

AttributeTypeDescription
urlStringThe article URL to analyze.

Response

Returns a JSON object with url as a string, clusters as an array of objects, primary_topic as a string, and related_keywords as a string array.

ParameterTypeDescription
urlStringThe article URL that was analyzed.
clustersObject ArrayGrouped themes containing specific keywords. Each item includes topic and keywords.
clusters[].topicStringThe cluster topic.
clusters[].keywordsString ArrayThe keywords belonging to the cluster.
primary_topicStringThe main topic identified for the article.
related_keywordsString ArrayA list of general keywords related to the article.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.