Mangools/API

Create trackings

Create multiple rank trackings at once for the same domain and keyword set. Pass location_ids[] and platform_ids[] — the endpoint creates a tracking for every (location × platform) combination that does not yet exist for the domain. Each new tracking receives the full keyword list and default weekly and monthly email reports.

Combinations already covered by an active tracking are skipped silently. If every combination already exists, the endpoint returns HTTP 409.

POST
/serpwatcher/multiple-trackings

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://api.mangools.com/v3/serpwatcher/multiple-trackings" \  -H "Content-Type: application/json" \  -d '{    "domain": "string",    "location_ids": [      0    ],    "platform_ids": [      0    ],    "keywords": [      "string"    ]  }'
[
  {
    "tracking": "string",
    "keywords": "string",
    "postponed_processing": "string"
  }
]
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}
{
  "error": {
    "type": "ValidationError",
    "message": "Your request is invalid",
    "errors": [
      "\"kw\" is required"
    ]
  }
}