Research

Keyword and competitor research

Research keyword opportunities

post

Get keyword ideas from seed keywords using DataForSEO. Returns search volume, difficulty, and intent data. Requires Power plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

seed_keywordsstring[] · min: 1 · max: 10Required

Seed keywords to research

locationstringOptionalDefault: United States

languagestringOptionalDefault: en

include_questionsbooleanOptionalDefault: true

limitnumber · min: 1 · max: 500OptionalDefault: 50

Responses

200

Keyword research results

application/json

post

/v1/research/keywords

HTTPcURLJavaScriptPython

POST /v1/research/keywords HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "seed_keywords": [
    "text"
  ],
  "location": "United States",
  "language": "en",
  "include_questions": true,
  "limit": 50
}

200

Keyword research results

{
  "keywords": [
    {
      "keyword": "text",
      "search_volume": 1,
      "keyword_difficulty": 1,
      "cpc": 1,
      "competition": "text",
      "search_intent": "text",
      "is_question": true
    }
  ],
  "total": 1,
  "seed_keywords": [
    "text"
  ],
  "location": "text"
}

Analyze SERP for a keyword

post

Get detailed SERP analysis including organic results, SERP features, People Also Ask, and search intent. Requires Power plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

keywordstring · max: 200Required

locationstringOptionalDefault: United States

languagestringOptionalDefault: en

Responses

200

SERP analysis results

application/json

post

/v1/research/serp

HTTPcURLJavaScriptPython

POST /v1/research/serp HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "keyword": "text",
  "location": "United States",
  "language": "en"
}

200

SERP analysis results

{
  "keyword": "text",
  "location": "text",
  "search_intent": "informational",
  "difficulty": "Low",
  "serp_features": [
    "text"
  ],
  "organic_results": [
    {
      "position": 1,
      "url": "text",
      "title": "text",
      "domain": "text"
    }
  ],
  "people_also_ask": [
    "text"
  ],
  "unique_domains": 1
}

Analyze competitor keywords

post

Get keywords that a competitor domain ranks for. Useful for competitive analysis and content gap identification. Requires Power plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

domainstringRequired

Competitor domain to analyze (e.g., "competitor.com")

locationstringOptionalDefault: United States

limitnumber · min: 1 · max: 200OptionalDefault: 50

Responses

200

Competitor keyword analysis

application/json

post

/v1/research/competitors

HTTPcURLJavaScriptPython

POST /v1/research/competitors HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "domain": "text",
  "location": "United States",
  "limit": 50
}

200

Competitor keyword analysis

{
  "domain": "text",
  "keywords": [
    {
      "keyword": "text",
      "search_volume": 1,
      "keyword_difficulty": 1,
      "cpc": 1,
      "competition": "text"
    }
  ],
  "total": 1,
  "total_volume": 1,
  "competition_breakdown": {
    "ANY_ADDITIONAL_PROPERTY": 1
  }
}

Cluster keywords by intent and topic

post

Group keywords by search intent (informational, commercial, transactional, navigational) and topic clusters. Useful for content planning and site architecture.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

keywordsstring[] · min: 1 · max: 500Required

methodstring · enumOptionalDefault: bothPossible values:

Responses

200

Keyword clustering results

application/json

post

/v1/research/cluster

HTTPcURLJavaScriptPython

POST /v1/research/cluster HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "keywords": [
    "text"
  ],
  "method": "both"
}

200

Keyword clustering results

{
  "intent_clusters": {
    "informational": [
      "text"
    ],
    "commercial": [
      "text"
    ],
    "transactional": [
      "text"
    ],
    "navigational": [
      "text"
    ]
  },
  "topic_clusters": [
    {
      "name": "text",
      "keywords": [
        "text"
      ],
      "count": 1
    }
  ],
  "total_keywords": 1,
  "method": "text"
}