# KeyClusters

> KeyClusters is a SaaS platform for SEO keyword clustering. Upload a list of keywords, and KeyClusters groups them into semantic clusters based on shared Google SERP (Search Engine Results Page) results — helping SEO professionals organize content strategies at scale.

## How It Works

1. Upload a CSV file containing keywords (up to 50,000+ keywords per job)
2. Map CSV columns to keyword, search volume, and keyword difficulty fields
3. Configure clustering settings: country, language, device (mobile/desktop), and sensitivity level (1–10)
4. KeyClusters fetches live Google search results for each keyword
5. Keywords that share ranking URLs are grouped into clusters
6. Download a structured Excel report with clustered keywords, metrics, and variations

## Key Concepts

- **Keyword Cluster**: A group of keywords that share common URLs in their Google search results, indicating they are semantically related and can be targeted together
- **Sensitivity**: Controls clustering aggressiveness on a scale of 1–10. Lower values create tighter clusters (fewer keywords per group, higher relevance). Higher values create broader clusters (more keywords grouped together). Default is 3
- **Cluster Percentage**: The percentage of uploaded keywords that were grouped into clusters containing 2 or more keywords
- **Variations**: Alternative keyword forms within a cluster that share the same ranking URLs
- **Credits**: The currency used to process keywords. Each keyword costs 1 credit to process
- **SERP**: Search Engine Results Page — the organic Google results analyzed for clustering

## Features

- **Bulk Keyword Clustering**: Process 30,000+ keywords in a single job
- **Multi-Region Support**: Cluster keywords for any Google country and language
- **Device-Specific Results**: Analyze mobile or desktop SERPs separately
- **Search Volume & KD Import**: Include volume and keyword difficulty data from your preferred SEO tool
- **Excel Reports**: Download structured XLSX reports with clusters, metrics, and keyword variations
- **Real-Time Progress**: Monitor job processing with live status updates
- **Credit-Based Pricing**: Pay per keyword processed with no monthly minimums
- **API Access**: Programmatic access via REST API with token authentication
- **Email Notifications**: Get notified when jobs complete
- **Job History**: Access all past clustering jobs and download results anytime

## API

KeyClusters provides a REST API for programmatic access.

### Authentication

All API requests require a token in the Authorization header:

```
Authorization: Token YOUR_API_TOKEN
```

API tokens can be generated and reset from the dashboard under Settings > API Keys.

### Endpoints

- `GET /api/jobs/data/` — List all jobs
- `POST /api/jobs/data/` — Create a new clustering job
- `GET /api/jobs/data/{id}/` — Get job details
- `PATCH /api/jobs/data/{id}/` — Update job (e.g., start processing)
- `GET /api/jobs/job-meta/{id}/` — Get job metadata and keyword counts
- `GET /api/jobs/dl-url/{id}/` — Get presigned download URL for results
- `GET /api/users/user/` — Get authenticated user profile
- `GET /api/users/api-key/` — Get API token
- `POST /api/users/reset-api-key/` — Generate new API token
- `GET /api/users/analytics-summary/` — Usage statistics
- `POST /api/billing/top-up/` — Purchase credits
- `GET /api/billing/` — List available products and plans

### Job Statuses

- `draft` — Job created but not yet started
- `queued` — Job submitted and waiting to be processed
- `inprogress` — Keywords are being fetched and clustered
- `complete` — Clustering finished, results available for download
- `invalid` — Job failed validation (e.g., invalid CSV format)
- `insufficient_credits` — Not enough credits to process all keywords
- `stopped` — Job manually stopped by user

## Pricing

KeyClusters uses a credit-based pricing model:
- 1 credit = 1 keyword processed
- Credits can be purchased as one-time top-ups or through subscription plans
- Auto top-up is available to automatically replenish credits when balance is low
- Free trial credits are available for new accounts

## Blog Articles

- [Keyword Clustering for Seasonal SEO: How to Plan Content Around Demand Spikes](https://www.keyclusters.com/blog/keyword-clustering-seasonal-seo): How to use SERP-based clustering to plan seasonal SEO — building a cluster map with demand timing overlaid, separating evergreen intent from genuinely seasonal intent, deciding between durable pages and dedicated seasonal pages, working publish dates backward from each peak to clear the indexing-and-trust lead time, refreshing returning pages before the ramp, maintaining recurring pages on persistent URLs across cycles, and reporting cluster-level seasonal share year over year instead of panicking at the off-season trough.
- [Keyword Clustering for Enterprise SEO: How to Govern Keywords at Scale Across Teams](https://www.keyclusters.com/blog/keyword-clustering-enterprise-seo): How large organizations use SERP-based clustering to govern keyword strategy across many teams — building a single source of cluster truth from the whole keyword corpus, assigning one accountable owner per cluster, resolving cross-team and cross-subdomain cannibalization, wiring clustering into intake and API workflows, and reporting cluster-level share of visibility to leadership.
- [Keyword Clustering for Site Migrations: Preserve Rankings Through Replatforms](https://www.keyclusters.com/blog/keyword-clustering-site-migrations): How to use SERP-based clustering to plan replatforms, domain changes, and IA overhauls that hold rankings — building the pre-migration cluster map, mapping old URLs to new URLs cluster by cluster, deriving redirect rules from the cluster mapping, running pre-launch cluster audits on staging, and monitoring post-launch trajectory at the cluster level where degradations surface in time to fix.
- [Keyword Clustering and Competitor Analysis: Reverse-Engineer Topical Authority](https://www.keyclusters.com/blog/keyword-clustering-and-competitor-analysis): How to use SERP-based clustering to dissect a competitor's ranking footprint at the cluster level — identifying clusters they own, clusters they touch but do not dominate, blind-spot clusters they have ignored, and clusters where they cannibalize themselves, then translating each signal into a different editorial response.
- [Keyword Clustering for Affiliate Marketing Sites: Building Topical Authority That Converts](https://www.keyclusters.com/blog/keyword-clustering-affiliate-marketing): How SERP-based clustering helps affiliate sites separate informational and commercial intent, structure niches into pillar categories, map clusters to roundup, comparison, and review formats, and prioritize cluster-level updates for the highest revenue impact.
- [Keyword Clustering for YouTube SEO: How to Build Video Topics That Rank](https://www.keyclusters.com/blog/keyword-clustering-for-youtube-seo): How SERP-based keyword clustering turns YouTube SEO from scattered uploads into a topical hub — sourcing seed queries from suggest and Google video carousels, mapping clusters to video formats, optimizing metadata from the cluster, and reporting at the cluster level across both YouTube and Google.
- [Keyword Clustering for Content Briefs: How to Turn Clusters into Publish-Ready Specs](https://www.keyclusters.com/blog/keyword-clustering-for-content-briefs): How to convert SERP-based keyword clusters into content briefs writers can actually ship — covering the cluster-to-brief schema, intent and entity coverage, internal linking specifications, and refresh triggers that keep briefs current as SERPs shift.
- [Keyword Clustering for Link Building: How to Earn Backlinks That Lift Whole Topics](https://www.keyclusters.com/blog/keyword-clustering-link-building): A cluster-first link building framework that prioritizes outreach by cluster value, maps clusters to link-worthy asset types (pillar pages, original research, tools, comparisons), routes earned equity through cluster-aware internal linking, and reports authority at the cluster level instead of one URL at a time.
- [Keyword Clustering with Google Search Console: A Practical Workflow](https://www.keyclusters.com/blog/keyword-clustering-with-search-console): How to cluster a Google Search Console query export with SERP-based clustering to produce a prioritized refresh, consolidate, create, and prune roadmap — including the position-eleven, cannibalization, and long-tail patterns that show up in every site.
- [Keyword Clustering for Featured Snippets: How to Win Position Zero at Scale](https://www.keyclusters.com/blog/keyword-clustering-for-featured-snippets): How SERP-based keyword clustering turns featured snippets from one-off optimizations into a repeatable program — identify snippet-eligible clusters, design lift-ready answer blocks, and track Position Zero share at the cluster level even as AI Overviews reshape the SERP.
- [Content Refresh with Keyword Clustering: How to Update Old Posts for Stronger Rankings](https://www.keyclusters.com/blog/keyword-clustering-content-refresh): A four-verdict refresh framework powered by SERP-based clustering — re-cluster old content against today's SERPs, decide what to update, merge, split, or prune, sequence the queue by ROI, and report refreshed traffic in a cohort dashboard.
- [Keyword Clustering for B2B SaaS: Mapping Clusters to the Buyer Journey](https://www.keyclusters.com/blog/keyword-clustering-b2b-saas): A practical playbook for B2B SaaS teams that maps SERP-based keyword clusters to each buyer journey stage, prioritizes by pipeline impact, and reports cluster-level ARR contribution to leadership.
- [Keyword Clustering for AI Overviews: How to Win Visibility in Generative Search](https://www.keyclusters.com/blog/keyword-clustering-ai-overviews): How to re-cluster keywords for AI Overviews and generative engine optimization, including trigger audits, citation-worthy pillar pages, and cluster-level GEO reporting that ties Overview behavior back to revenue.
- [Keyword Clustering for Programmatic SEO: How to Build Templated Content at Scale](https://www.keyclusters.com/blog/keyword-clustering-programmatic-seo): How SERP-based clustering turns programmatic SEO from a doorway-page risk into a system, covering modifier discovery, cluster-to-template mapping, cluster-level reporting, and pruning rules that keep templated builds compounding.
- [Keyword Clustering and PPC: How to Use SEO Cluster Logic to Sharpen Paid Search](https://www.keyclusters.com/blog/keyword-clustering-and-ppc): How SERP-based keyword clusters translate into tighter ad groups, smarter negatives, healthier Quality Scores, and shared SEO+PPC reporting that stops the two channels from cannibalizing each other.
- [Multilingual Keyword Clustering: How to Scale SEO Across Languages and Markets](https://www.keyclusters.com/blog/multilingual-keyword-clustering): A practical guide to building locally grounded keyword clusters across multiple languages and markets, covering localized SERPs, translation pitfalls, hreflang linking, and reporting that scales globally.
- [Keyword Clustering for Content Marketing: Build Topical Authority That Converts](https://www.keyclusters.com/blog/keyword-clustering-for-content-marketing): A practical workflow for using keyword clusters to power content marketing — from topic discovery and format mapping to calendars and cluster-level reporting executives can act on.
- [Keyword Intent Clustering: Group Keywords by Search Intent for Better SEO Results](https://www.keyclusters.com/blog/keyword-intent-clustering): How to group keywords by the underlying purpose of the search so each page targets a single intent and ranks for dozens of related queries.
- [Keyword Clustering Case Study: How a SaaS Site 3x'd Organic Traffic in 9 Months](https://www.keyclusters.com/blog/keyword-clustering-case-study): A real anonymized case study walking through the clustering workflow a B2B SaaS site used to triple organic traffic in nine months, including consolidation, cluster-first publishing, and what didn't work.
- [Automated Keyword Clustering: How to Scale SEO Research Without Sacrificing Accuracy](https://www.keyclusters.com/blog/automated-keyword-clustering): How automated keyword clustering works, when to trust it, and how to build a repeatable workflow that turns thousands of keywords into a publish-ready content plan.
- [Keyword Clustering vs. Keyword Grouping: What's the Difference and Which Do You Need?](https://www.keyclusters.com/blog/keyword-clustering-vs-keyword-grouping): Explains the core differences between keyword clustering and keyword grouping, when to use each approach, and why SERP-based clustering delivers superior SEO results.
- [Local SEO Keyword Clustering: How to Dominate Local Search Results](https://www.keyclusters.com/blog/local-seo-keyword-clustering): Learn how to apply keyword clustering to local SEO campaigns by grouping location-based queries, building local landing pages, and avoiding thin doorway pages.
- [Long-Tail Keyword Clustering: How to Find and Group Low-Competition Keywords That Convert](https://www.keyclusters.com/blog/long-tail-keyword-clustering): Learn how to cluster long-tail keywords into targeted content groups that drive qualified traffic with higher conversion rates.
- [Semantic Keyword Clustering: How to Group Keywords by Meaning for Better SEO](https://www.keyclusters.com/blog/semantic-keyword-clustering): Learn how semantic clustering groups keywords by meaning instead of exact match to build topical depth and rank faster.
- [Keyword Clustering Tools Compared: Find the Best Fit for Your SEO Workflow](https://www.keyclusters.com/blog/keyword-clustering-tools-comparison): Side-by-side comparison of the top keyword clustering tools covering methods, accuracy, pricing, and workflow fit.
- [Topical Authority and Keyword Clustering: How to Become Google's Expert on Any Topic](https://www.keyclusters.com/blog/topical-authority-keyword-clustering): How to use keyword clustering to build topical authority with the pillar-cluster framework and SERP-based grouping.
- [How to Do Keyword Clustering: A Step-by-Step Guide for SEO Success](https://www.keyclusters.com/blog/how-to-do-keyword-clustering): Practical step-by-step guide to keyword clustering covering data collection, SERP-based grouping, and content strategy.
- [Keyword Clustering for Agencies: Scale SEO Delivery Across Every Client](https://www.keyclusters.com/blog/keyword-clustering-agencies): How SEO agencies use keyword clustering to onboard clients faster, eliminate cannibalization at scale, and deliver measurable topical authority results.
- [Keyword Clustering for SEO: The Complete Strategy Guide](https://www.keyclusters.com/blog/keyword-clustering-seo): Learn how keyword clustering for SEO works, why it outperforms single-keyword targeting, and how to build a content strategy that ranks for hundreds of queries.
- [Keyword Mapping for SEO: The Complete Guide to Assigning Keywords to Pages](https://www.keyclusters.com/blog/keyword-mapping-seo): Learn how to create a keyword map that assigns clustered keywords to specific URLs for better SEO.
- [Best Keyword Grouping Tool: Why KeyClusters Outperforms the Competition](https://www.keyclusters.com/blog/best-keyword-grouping-tool): Compare the top keyword grouping tools and discover why KeyClusters is the best choice.
- [What is Keyword Clustering and Why It Matters for SEO](https://www.keyclusters.com/blog/what-is-keyword-clustering): Discover how keyword clustering transforms your SEO strategy.
- [How to Prevent Keyword Cannibalization with Smart Clustering](https://www.keyclusters.com/blog/prevent-keyword-cannibalization): Learn how keyword cannibalization hurts rankings and how clustering helps.
- [SERP-Based Keyword Clustering vs. Traditional Methods](https://www.keyclusters.com/blog/serp-based-clustering): Why real-time SERP analysis produces more accurate keyword clusters.
- [The Ultimate Guide to Building Content Hubs with Keyword Clusters](https://www.keyclusters.com/blog/building-content-hubs): Step-by-step guide to creating powerful content hubs.
- [10 Keyword Clustering Mistakes That Are Hurting Your SEO](https://www.keyclusters.com/blog/keyword-clustering-mistakes): Avoid common keyword clustering pitfalls.
- [How to Structure Your Website Using Keyword Clusters](https://www.keyclusters.com/blog/structure-website-keyword-clusters): Create a logical, SEO-friendly site architecture.
- [Keyword Clustering for E-commerce: A Step-by-Step Guide](https://www.keyclusters.com/blog/keyword-clustering-ecommerce): Optimize product pages and category structure with clustering.
- [The ROI of Keyword Clustering: Time Saved vs. Manual Research](https://www.keyclusters.com/blog/roi-keyword-clustering): Calculate the real return on investment of automated clustering.
- [How to Use Keyword Clustering to Improve Your Internal Linking](https://www.keyclusters.com/blog/internal-linking-keyword-clusters): Build strategic internal linking with keyword clusters.
- [Keyword Clustering Best Practices for 2026](https://www.keyclusters.com/blog/keyword-clustering-best-practices): Latest techniques aligned with current search algorithms.

## Links

- Website: https://keyclusters.com
- App: https://app.keyclusters.com
- Dashboard: https://app.keyclusters.com/dashboard
- Login: https://app.keyclusters.com/auth/login
- Register: https://app.keyclusters.com/auth/register