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 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
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": [ { "keyword": "string" } ], "tag_ids": [ "string" ] }'{
"tracking": {
"_id": "string",
"domain": "string",
"location": {
"_id": 2703,
"label": "Slovakia",
"code": "us"
},
"platform_id": 0,
"count": 0,
"tracked_keyword_ids": [
"string"
],
"tracking_config": {
"address": "string",
"ludocid": "string",
"name": "string",
"place_id": "string"
},
"share_token": "string",
"created_at": 0,
"is_deleted": true,
"reports_active": [
0
],
"stats": {
"timeframes": {
"property1": {
"estimated_visits": 0,
"performance_index": 0,
"visibility_index": 0,
"performance_total": 0,
"rank_distribution": {
"1": 0,
"3": 1,
"10": 3,
"20": 0,
"100": 0,
"rest": 5
},
"keywords_with_history": 0,
"keywords_eligible": 0
},
"property2": {
"estimated_visits": 0,
"performance_index": 0,
"visibility_index": 0,
"performance_total": 0,
"rank_distribution": {
"1": 0,
"3": 1,
"10": 3,
"20": 0,
"100": 0,
"rest": 5
},
"keywords_with_history": 0,
"keywords_eligible": 0
}
}
}
},
"keywords": [
{
"keyword_id": "string",
"tracking_id": "string",
"user_id": "string",
"kw": "string",
"location_id": 0,
"platform_id": 0
}
],
"postponed_processing": true,
"postponed_keywords": 0,
"estimatedTimeProcessing": 0
}{
"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"
]
}
}