▣ 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

http://localhost:8080/namastesumalya/generate-keyword-clusters

QUICKSTARTGUIDE

Quickstart

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

curl -X GET "http://localhost:8080/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

API key

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)

Attribute	Type	Mandatory	Description
url	String	Yes	The 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.

Parameter	Type	Mandatory	Description
url	String	No	The article URL that was analyzed.
clusters	Object Array	No	Grouped themes containing specific keywords. Each item includes `topic` and `keywords`.
clusters[].topic	String	No	The cluster topic.
clusters[].keywords	String Array	No	The keywords belonging to the cluster.
primary_topic	String	No	The main topic identified for the article.
related_keywords	String Array	No	A list of general keywords related to the article.

Query parameters

Name

Type

Description

urlREQUIRED

string

—

▣ 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.