Mangools/API

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 in YYYY-MM-DD format
  • text — annotation text
  • nonShareable — optional boolean; when true the annotation is hidden from shared dashboard links
POST
/serpwatcher/trackings/{tracking_id}/annotations

Authorization

ApiKeyAuth
x-access-token<token>

Your Mangools API key

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.

body?unknown

Response Body

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
}