Skip to main content

​
What is SuprKeywords?

SuprKeywords is an API-first keyword research platform. You provide a primary domain, optional competitor domains, and a language/location. The pipeline generates customer personas, seed keywords, enriches and expands them via DataForSEO, then clusters results into pillar and supporting keywords with opportunity scores.

Open the dashboard

Create jobs, view results, and export keywords from the web app.

​
What you can do with the API

  • Create jobs – Submit a keyword research job (primary domain, competitors, locale). One run is debited upfront; the pipeline runs asynchronously.
  • List and inspect jobs – Get job status, progress, and metadata. When a job is completed or failed, fetch total keyword count and error details.
  • Fetch results – Get personas, keywords (with filters and pagination), clusters, and keywords within each cluster. Export all keywords as CSV.
  • Locale data – List available languages and locations (DataForSEO-compatible) for job creation.
The API is served from the same origin as the dashboard: https://suprkeywords.com/app. All endpoints live under /api/v1/. Dashboard users are authenticated via Clerk (session cookie). API keys for programmatic access are planned for a later release.

API Reference

Base URL, authentication, and endpoint reference generated from OpenAPI.

​
Next steps

Quickstart

Run a job and fetch results in a few steps.

API Reference

Endpoints, request/response shapes, and examples.