Get detail of tracking
Get aggregated rank tracking statistics and per-keyword rank data for a tracking over the requested date range (from, to).
For each keyword the response contains:
- current rank, best rank and average rank
- rank change and estimated visits deltas
- rank history sampled across the range
- presence and position in Map Pack and Featured Snippet
- detected SERP features
- last-check and last-crawl timestamps
Optionally pass kwIds in the request body to limit the response to a specific subset of tracked keywords. The response also includes annotations overlapping the date range.
Shared access
Supports a read-only share_token for sharing a dashboard without account credentials.
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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://api.mangools.com/v3/serpwatcher/trackings/string/stats" \ -H "Content-Type: application/json" \ -d '{}'{
"annotations": [
{
"date": "string",
"content": {
"text": "string",
"keywords_count": 0,
"avg": 0,
"platformId": 0
},
"tracking_id": "string",
"user_id": "string",
"created_at": "string",
"type": 0
}
],
"history_dates": [
"2021-10-20",
"2021-10-08",
"2021-9-29"
],
"stats": {
"all": [
{
"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
}
],
"selected": [
{
"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
}
]
}
}{
"error": {
"type": "AuthError",
"message": "Invalid API Key"
}
}{
"error": {
"type": "Error",
"message": "Tag not found"
}
}