Creates new annotation
Create a user annotation pinned to a specific date on the tracking timeline. Annotations are rendered as markers on rank history charts and help explain ranking changes (site launches, marketing campaigns, algorithm updates, etc.).
Required fields:
date— annotation date inYYYY-MM-DDformattext— annotation textnonShareable— optional boolean; whentruethe annotation is hidden from shared dashboard links
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
ID of Tracking that the annotation will be created on
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://api.mangools.com/v3/serpwatcher/trackings/string/annotations" \ -H "Content-Type: application/json" \ -d '{ "date": "string", "text": "string" }'{
"date": "string",
"content": {
"text": "string",
"keywords_count": 0,
"avg": 0,
"platformId": 0
},
"tracking_id": "string",
"user_id": "string",
"created_at": "string",
"type": 0
}{
"error": {
"type": "AuthError",
"message": "Invalid API Key"
}
}