Skip to main content

Make your first Keupera API request

Follow these three steps to authenticate, call an endpoint, and inspect a response from the Keupera Public API.

Step 1: Generate an API key

  1. Log in to your Keupera dashboard.
  2. Go to Settings → API Keys.
  3. Click Create API key and copy it somewhere safe — you won’t see it again.
Treat your API key like a password. Never commit it to source control or expose it in client-side code.
Public API access is tied to your subscription tier. If requests return 403 Forbidden, upgrade your plan from Settings → Billing or contact ask@support.keupera.com.

Step 2: Call your first endpoint

All endpoints live under:
https://app.keupera.com/api/v1/<function-name>
Authenticate using a Bearer token in the Authorization header. Here’s a minimal request that lists keywords for the website attached to your API key:
curl https://app.keupera.com/api/v1/public-api-keywords/keywords \
  -H "Authorization: Bearer $KEUPERA_API_KEY"

Step 3: Inspect the response

Successful responses return JSON with a consistent shape:
{
  "data": [
    {
      "id": "uuid",
      "term": "best seo tools",
      "volume": 12000,
      "difficulty": 45,
      "status": "active"
    }
  ],
  "meta": { "total": 150, "page": 1, "limit": 100 }
}
Errors return an error string with an HTTP status code between 400 and 500:
{ "error": "Invalid or missing API key" }

Next steps

Explore the API modules to build deeper integrations:

Keywords

Research, enrich, and manage keywords programmatically.

Backlinks

Run outreach campaigns and track backlink opportunities.

Content

Plan, generate, and schedule AI-written articles.

AI Visibility

Monitor your brand across LLM answers.

Analytics

Traffic, Search Console, and AI bot crawl data.

Full API overview

Authentication, pagination, and error reference.
Need help? Email ask@support.keupera.com or open the in-app chat from your dashboard.