Mangools API Documentation

Get aggregated rank tracking statistics and per-keyword rank data for a tracking over the requested date range (from, to).

For each keyword the response contains:

current rank, best rank and average rank
rank change and estimated visits deltas
rank history sampled across the range
presence and position in Map Pack and Featured Snippet
detected SERP features
last-check and last-crawl timestamps

Optionally pass kwIds in the request body to limit the response to a specific subset of tracked keywords. The response also includes annotations overlapping the date range.

Shared access

Supports a read-only share_token for sharing a dashboard without account credentials.

Authorization

ApiKeyAuth

x-access-token<token>

Your Mangools API key

In: header

Path Parameters

tracking_id*string

tracking_id

Query Parameters

from?string

Filter from date

to?string

Filter to date

kwIds?array<string>

Filter to date

Response Body

`application/json`

curl -X POST "https://api.mangools.com/v3/serpwatcher/trackings/string/stats"

{
  "annotations": [
    {
      "date": "string",
      "content": {
        "text": "string",
        "keywords_count": 0,
        "avg": 0,
        "platformId": 0
      },
      "tracking_id": "string",
      "user_id": "string",
      "created_at": "string",
      "type": 0
    }
  ],
  "history_dates": [
    "2021-10-20",
    "2021-10-08",
    "2021-9-29"
  ],
  "stats": {
    "all": [
      {
        "estimated_visits": 0,
        "performance_index": 0,
        "performance_total": 0,
        "rank_distribution": {
          "1": 0,
          "3": 1,
          "10": 3,
          "20": 0,
          "100": 0,
          "rest": 5
        }
      }
    ],
    "selected": [
      {
        "estimated_visits": 0,
        "performance_index": 0,
        "performance_total": 0,
        "rank_distribution": {
          "1": 0,
          "3": 1,
          "10": 3,
          "20": 0,
          "100": 0,
          "rest": 5
        }
      }
    ]
  }
}