Mangools API Documentation

Get a lightweight snapshot of a tracking together with its tracked keyword list for the requested date range (from, to). Each keyword includes its id, text, currently ranking URL (as of the latest date), assigned tags and last-check timestamp. Rank history and aggregated statistics are intentionally omitted — use POST /serpwatcher/trackings/{tracking_id}/stats for those.

Set is_with_deleted=true to include previously deleted keywords.

Shared access

The endpoint also accepts a read-only share_token query parameter, allowing dashboards to be shared without exposing 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

is_with_deleted?string

Ability to return deleted kws

Response Body

`application/json`

curl -X GET "https://api.mangools.com/v3/serpwatcher/trackings/string/detail"

{
  "tracking": {
    "count": 0,
    "created_at": 0,
    "domain": "string",
    "location": {
      "_id": 0,
      "label": "Slovakia",
      "code": null
    },
    "platform_id": 0,
    "share_token": "string",
    "tracked_keyword_ids": [
      "string"
    ],
    "tracking_config": {
      "address": "string",
      "ludocid": "string",
      "name": "string",
      "place_id": "string"
    },
    "_id": "string"
  },
  "keywords": [
    {
      "created_at": 0,
      "estimated_visits": 0,
      "kw": "string",
      "kwId": "string",
      "last_checked_at": 0,
      "map_pack": {
        "estimated_visits": 0,
        "estimated_visits_item": 0,
        "hasUrl": 0,
        "rank": 0
      },
      "rank": {
        "avg": 3,
        "best": 6,
        "last": 1
      },
      "rank_history": [
        3,
        5,
        6
      ],
      "search_volume": 0,
      "tags": [
        {
          "user_id": "string",
          "tracking_id": "string",
          "name": "string",
          "color": "string",
          "created_at": "string"
        }
      ],
      "url": "string",
      "_id": "string"
    }
  ]
}