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": [
{
"_id": "string",
"date": "string",
"content": {
"text": "string",
"keywords_count": 0,
"avg": 0,
"platformId": 0
},
"nonShareable": true,
"tracking_id": "string",
"user_id": "string",
"creator": "string",
"created_at": 0,
"type": 0
}
],
"history_dates": [
"2021-10-20",
"2021-10-08",
"2021-9-29"
],
"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
}
},
"top_up": [
"string"
],
"top_down": [
"string"
]
},
"keywords": [
{
"_id": "string",
"rank_change": 0,
"search_volume": 0,
"is_more_url": true,
"visual_metrics": {
"status": "above",
"serp_coverage": 0,
"serp_coverage_change": 0,
"above_the_fold": 0,
"above_the_fold_change": 0,
"from_top_edge": 0,
"from_top_edge_change": 0
},
"serp_features": [
"MAP_PACK"
],
"map_pack": {
"rank": 0,
"url": "string",
"hasUrl": true
},
"feat_snippet": {
"serpRank": 0,
"url": "string",
"isRanking": true
},
"estimated_visits": 0,
"rank": {
"last": 0,
"avg": 0,
"best": 0
},
"last_checked_at": 0,
"last_crawled_at": "string",
"rank_check_pending": true,
"estimated_visits_change": 0,
"estimated_visits_total_change": 0,
"performanceIndexChange": 0,
"rank_history": [
0
],
"is_empty_main_array": true,
"nearest_before_day": "string"
}
]
}{
"error": {
"type": "AuthError",
"message": "Invalid API Key"
}
}{
"error": {
"type": "Error",
"message": "Tag not found"
}
}