Mangools/API

Get current and free limits

Get your current API usage and remaining limits across every Mangools resource — Keyword lookups, SERP lookups, Backlink rows, Tracked keywords, and more. Useful for quota checks before sending expensive requests, or for surfacing usage information in a client dashboard.

Authentication is optional on this operation: a request without X-Access-Token, or with a token that matches no account, returns HTTP 200 with nothing remaining in any pool rather than HTTP 401. Do not use this operation to validate an API key — use one that requires authentication, such as GET /kwfinder/requests.

GET
/kwfinder/limits

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

Response Body

application/json

text/html

curl -X GET "https://api.mangools.com/v3/kwfinder/limits"
{
  "competitor-keywords-rows": 2000,
  "related-keywords-rows": 700,
  "reqs-per-short-period": 3,
  "api_quota": {
    "related-keywords": {
      "limit": 100,
      "remaining": 99,
      "reset": 35000
    },
    "serps": {
      "limit": 100,
      "remaining": 100,
      "reset": null
    }
  },
  "permanent_credits": {
    "related-keywords": {
      "limit": 100,
      "remaining": 99
    },
    "serps": {
      "limit": 100,
      "remaining": 100
    }
  },
  "resources": {
    "related-keywords": {
      "limit": 500,
      "remaining": 497,
      "reset": 7796
    },
    "trends": {
      "limit": 500,
      "remaining": 499,
      "reset": 8300
    },
    "tracked_keywords": {
      "limit": 1651,
      "remaining": 1651
    },
    "serps": {
      "limit": 500,
      "remaining": 496,
      "reset": 7769
    },
    "links": {
      "limit": 100000,
      "remaining": 99500,
      "reset": 572091
    },
    "sch-url-metrics": {
      "limit": 600,
      "remaining": 600,
      "reset": 7769
    },
    "kw-url-metrics": {
      "limit": 600,
      "remaining": 600,
      "reset": 7769
    },
    "lm-url-metrics": {
      "limit": 100000,
      "remaining": 99999,
      "reset": 14958
    },
    "sp-overview": {
      "limit": 70,
      "remaining": 70,
      "reset": 14958
    },
    "lm-suggest": {
      "limit": 100,
      "remaining": 100,
      "reset": 14958
    },
    "ai-watcher-prompts": {
      "limit": 100,
      "remaining": 96,
      "reset": null
    },
    "ai-watcher-monitors": {
      "limit": 3,
      "remaining": 2,
      "reset": null
    },
    "checked-keywords-ranks": {
      "limit": 1651,
      "remaining": 1651,
      "reset": null
    }
  },
  "tracked-keywords": 1500,
  "upgraded_account": true,
  "limit_options": [
    {
      "name": "Related keywords",
      "tooltip": "string",
      "limits": [
        {
          "plan": "BASIC",
          "value": "200",
          "color": "orange"
        }
      ]
    }
  ],
  "highestPlan": "premium",
  "platformPlan": "mangools",
  "trackings": 10,
  "maxGeneratePrompts": 5
}
"<html>\n<head><title>429 Too Many Requests</title></head>\n<body>\n<center><h1>429 Too Many Requests</h1></center>\n</body>\n</html>\n"