Competitor Keyword Gap

GET /v1/keywords/gap

opportunityScore =
    volumeScore                                  // bigger traffic = bigger upside
  × (1 − difficulty/100)                          // prefer attainable
  × (1 − bestCompetitorRank/100)                  // competitor in top 10 = real signal
  × (yourRank IS NULL ? 1.0
        : yourRank/100)                          // bigger gap to close = bigger upside

{
  "ok": true,
  "data": {
    "appId": "123456789",
    "competitorIds": ["456", "789"],
    "country": "us",
    "device": "iphone",
    "opportunities": [
      {
        "keyword": "school",
        "bestCompetitor": "456",
        "bestCompetitorRank": 18,
        "yourRank": null,
        "volumeScore": 82,
        "difficulty": 43,
        "opportunityScore": 38.33
      },
      {
        "keyword": "productivity",
        "bestCompetitor": "456",
        "bestCompetitorRank": 18,
        "yourRank": 71,
        "volumeScore": 68,
        "difficulty": 43,
        "opportunityScore": 22.59
      }
    ],
    "summary": {
      "totalGaps": 25,
      "avgVolumeScore": 54.7,
      "avgDifficulty": 41.2
    }
  }
}