Mangools/API

Keyword Gap Analysis

Find keywords that your competitors rank for but your domain doesn't — the classic SEO content-gap analysis. Compare your domain against up to 5 competitors.

Request body:

  • domain — your domain to analyze
  • competitors — array of 1–5 competitor domains
  • location_id — location for the analysis
  • page — optional pagination parameter (Premium and Agency plans only)

The response is sorted by opportunity — keywords where every competitor ranks and you don't appear first. Each keyword includes search volume, keyword difficulty, CPC and the ranking URL of each competitor for that keyword.

Limits

Counts toward your Keyword lookups limit. Identical requests within 24 hours are reused from cache.

POST
/kwfinder/gap-analysis

Authorization

ApiKeyAuth
x-access-token<token>

API token issued for your Mangools account, sent as an API key in the x-access-token HTTP header. This is NOT a standard RFC 6750 Authorization: Bearer <token> header. Auto-generated clients should be configured to send the token in x-access-token accordingly.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://api.mangools.com/v3/kwfinder/gap-analysis" \  -H "Content-Type: application/json" \  -d '{    "domain": "mangools.com",    "competitors": [      "ahrefs.com",      "semrush.com"    ],    "location_id": 2840  }'
{
  "isAllowedPagination": true,
  "page": 1,
  "resultsSize": 1000,
  "results": [
    {
      "domain": "ahrefs.com",
      "total_count": 5432,
      "items": [
        {
          "keyword": "backlink checker",
          "search_volume": 12100,
          "cpc": 5.24,
          "competition": 0.85,
          "competitor_position": 3,
          "your_position": null
        }
      ]
    }
  ]
}
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}
{
  "error": {
    "type": "RateLimit",
    "message": "Not enough limits 2"
  }
}