apyhub
▣ MARKETING · SEO

Generate Keyword Clusters API

What it does

Keyword Clustering groups the keywords from a single article into topic-based clusters. Send a url, and get back the article url, a clusters array with each cluster's topic and keywords, plus a primary_topic and related_keywords list.

Use it when you need to turn a long article into an SEO or content-planning view. The clustered output helps you see which themes dominate a page, which terms belong together, and which broader keywords are relevant to the article as a whole.

Keyword Clustering is useful for content audits, topic mapping, and search intent analysis. For example, you can feed in a blog post URL and use the returned clusters to build internal linking plans, refine metadata, or compare how well a page covers its main subject.

The response stays simple and structured, so it fits cleanly into content pipelines, analysis dashboards, or downstream SEO workflows.

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

QUICKSTART

GUIDE

Quickstart

Fetch keyword clusters for a page by passing its url as a query parameter.

curl -X GET "https://api.eu.apyverse.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 these top-level fields: url as a string, clusters as an array of objects, primary_topic as a string, and related_keywords as an array of strings.

Each item in clusters contains a topic string and a keywords 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 from an article URL. It takes the article url as input and returns the analyzed URL along with clustered topics, a primary topic, and related keywords.

Query Parameter(s)

AttributeTypeMandatoryDescription
urlStringYesThe 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.

ParameterTypeMandatoryDescription
urlStringNoThe article URL that was analyzed.
clustersObject ArrayNoGrouped themes containing specific keywords. Each item includes:<br>- topic as a string<br>- keywords as a string array
clusters[].topicStringNoThe topic name for the cluster.
clusters[].keywordsString ArrayNoKeywords associated with the cluster.
primary_topicStringNoThe primary topic identified from the article.
related_keywordsString ArrayNoA 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.

Product
CatalogPricingQuickstartBecome a providerStatus (opens in new tab)
Company
AboutBlogCareers (opens in new tab)Contact
Legal
Terms of ServicePrivacy PolicyProvider terms
© 2026 APYHUB · BUILT FOR DEVELOPERS