Mangools/API

Get tracking detail and its keywords

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.

GET
/serpwatcher/trackings/{tracking_id}/detail

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

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

application/json

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": "us"
    },
    "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"
    }
  ]
}
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}
{
  "error": {
    "type": "Error",
    "message": "Tag not found"
  }
}