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.
Authorization
ApiKeyAuth 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"
]
}
}