Mangools/API

Track another keyword

Add new keywords to an existing tracking.

Request body:

  • keywords — array of keyword strings to add
  • tag_ids — optional array of tag IDs to assign to every added keyword (tags must already exist on the tracking)

Keywords already tracked on this tracking are not re-added — their tags are simply extended with the provided ones. Only truly new keywords count against your tracked-keyword limit. The response returns both existing and newly added keywords in a single merged list.

POST
/serpwatcher/trackings/{tracking_id}/tracked-keywords

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

share_token?string

share_token

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.mangools.com/v3/serpwatcher/trackings/string/tracked-keywords" \  -H "Content-Type: application/json" \  -d '{    "keywords": [      "string"    ],    "tag_ids": [      "string"    ]  }'
{
  "keyword_id": "string",
  "tracking_id": "string",
  "user_id": "string",
  "kw": "string",
  "location_id": "string",
  "platform_id": "string"
}
{
  "error": {
    "type": "AuthError",
    "message": "Invalid API Key"
  }
}
{
  "error": {
    "type": "Error",
    "message": "Tag not found"
  }
}
{
  "error": {
    "type": "ValidationError",
    "message": "Your request is invalid",
    "errors": [
      "\"kw\" is required"
    ]
  }
}