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 every limit reported as zero 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
    }
  },
  "resources": {
    "related-keywords": {
      "limit": 500,
      "remaining": 497,
      "reset": 7796
    },
    "trends": {
      "limit": 500,
      "remaining": 499,
      "reset": 8300
    },
    "tracked_keywords": {
      "limit": 1651,
      "remaining": 1651,
      "reset": 62736
    },
    "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
    }
  },
  "tracked-keywords": 1500,
  "upgraded_account": true
}
"<html>\n<head><title>429 Too Many Requests</title></head>\n<body>\n<center><h1>429 Too Many Requests</h1></center>\n<hr><center>nginx</center>\n</body>\n</html>\n"