API referenceRankings and status
Usage rankings
Top capabilities, providers, categories and opted-in apps by calls and hits over the last day, week or month across all GridRouter traffic, with change vs the previous window and trending movers.
Query Parameters
window?string
Default
"week"Value in
- "day"
- "week"
- "month"
category?string
Match
^[a-z]+$Length
length <= 40limit?integer
Range
1 <= value <= 50Default
20Response Body
application/json
application/json
curl -X GET "https://example.com/v1/rankings"{ "object": "rankings", "window": "day", "category": "string", "source": "live", "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "generated_at": "2019-08-24T14:15:22Z", "capabilities": [ { "id": "string", "name": "string", "category": "string", "calls": 0, "hits": 0, "hit_rate": 0, "share": 0, "change": 0 } ], "providers": [ { "id": "string", "name": "string", "category": "string", "calls": 0, "hits": 0, "hit_rate": 0, "share": 0, "change": 0 } ], "apps": [ { "id": "string", "name": "string", "category": "string", "calls": 0, "hits": 0, "hit_rate": 0, "share": 0, "change": 0 } ], "categories": [ { "id": "string", "name": "string", "category": "string", "calls": 0, "hits": 0, "hit_rate": 0, "share": 0, "change": 0 } ], "movers": [ { "id": "string", "name": "string", "category": "string", "calls": 0, "hits": 0, "hit_rate": 0, "share": 0, "change": 0, "kind": "capability" } ], "series": [ { "date": "2019-08-24", "id": "string", "calls": 0 } ]}Search vendors GET
Every GTM data vendor GridRouter knows about (integrated or researched): API access, spec status, published rate limits and marketplace listings.
Provider status GET
Live health per provider: vendor failures in the last 30 seconds (the router's outage signal), last-hour error rate and latency, and 24-hour and 30-day uptime with daily bars.