---
title: Analyse Keywords API
slug: extract-and-group-keywords-from-article
url: https://apyhub.com/apyhub/service/extract-and-group-keywords-from-article
provider: ApyHub
categories: [Ingestion Kit, Model Kit, Retrieval Kit]
tags: [keyword-extraction, keyword-grouping, article-analysis, content-clustering, seo]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 200
mcp: true
alias: analyse-keywords
---

# Analyse Keywords API

Analyze a public article URL and get ranked keyword groups with scores. Built for content clustering, topic analysis, and SEO strategy workflows.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/apyhub/extract-and-group-keywords-from-article` | What it does Extracts and groups keywords from one or more publicly accessible article URLs. The re… | 200 |

## Endpoint reference

### Extract and group keywords from article URLs

`POST https://api.eu.apyhub.com/apyhub/extract-and-group-keywords-from-article` · 200 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `urls` | body | array of string | yes | Publicly accessible article URLs to analyse. Maximum 10; extras are ignored. Example: `["https://assets.apyhub.com/samples/sample.html","https://assets.apyhub.com/sam…`. |
| `article_length` | body | integer | no | Expected article character length hint (optional; helps the parser tune extraction). |
| `return_results_top` | body | integer | no | Maximum number of keyword groups to return (5–50). Omit to return all groups. Example: `20`. |

#### Quickstart

Send a list of article URLs to extract and group their keywords.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/extract-and-group-keywords-from-article" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://assets.apyhub.com/samples/sample.html"
    ]
  }'
```

#### What you'll get back

Returns a JSON object with a `data` object. Inside `data`, `keyword_groups` is an array of ranked keyword groups, and each group contains a numeric `score` and a `keywords` array of strings.

```json
{
  "data": {
    "individual_results": [
      {
        "url": "https://assets.apyhub.com/samples/sample.html",
        "latent_semantic_keywords": [
          "eligendi",
          "expedita",
          "eos",
          "alias",
          "aliquid",
          "dignissimos",
          "ea",
          "eaque",
          "aliquam",
          "dicta"
        ],
        "high_frequency_keywords": [
          {
            "keyword": "et",
            "frequency": 56
          },
          {
            "keyword": "ut",
            "frequency": 35
          }
        ],
        "high_frequency_keyphrases": [
          {
            "keyphrase": "consequatur et",
            "frequency": 3
          },
          {
            "keyphrase": "mollitia et",
            "frequency": 3
          }
        ],
        "preview": "Lorem ipsum dolor sit amet...."
      }
    ],
    "aggregated_results": null
  }
}
```

## About

## What it does
Keyword Grouping analyzes one to ten publicly accessible article URLs and returns ranked keyword groups for the content it finds. Send article URLs, optionally include an `article_length` hint, and set `return_results_top` if you want to limit how many groups come back.

Use Keyword Grouping when you need to compare articles by topic, cluster related terms across a content library, or pull out the main themes from a batch of pages. The service is built for article analysis, so it works well for editorial workflows, content research, and SEO tooling where you want grouped terms instead of a flat keyword list.

The response contains `data.keyword_groups`, an array of objects with a numeric `score` and a `keywords` array. Each group represents a ranked set of related keywords extracted from the provided articles, which makes it easy to sort by relevance or feed the results into downstream classification, search, or reporting jobs.

Because the input is limited to public article URLs, this is a good fit for pipelines that analyze published pages without uploading files or raw HTML. Send the URLs, get structured keyword groups back, and use them to identify repeated topics, build content clusters, or surface the terms that matter most across a set of articles.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/extract-and-group-keywords-from-article
