Track another keyword
Add new keywords to an existing tracking.
Request body:
keywords— array of keyword strings to addtag_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.
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
Path Parameters
tracking_id
Query Parameters
Filter from date
Filter to date
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"
]
}
}