ReferenceAPI
System
Get public API metadata
Returns a minimal bootstrap payload describing the current Trendtrack Public API version and status.
Response Body
application/json
application/json
curl -X GET "https://api.trendtrack.io/v1"{
"name": "Trendtrack Public API",
"version": "v1",
"status": "ok"
}{
"error": {
"code": "missing_api_key",
"message": "Provide an API key using Authorization: Bearer <api_key>.",
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
"details": {
"validationErrors": [
{
"field": "query-string.limit",
"location": "query-string",
"expected": [
"limit must not be greater than 100"
]
}
]
}
}
}Check public API health
Returns a lightweight health payload for the public bootstrap mounted under /v1.
Response Body
application/json
application/json
curl -X GET "https://api.trendtrack.io/v1/health"{
"status": "ok",
"timestamp": "2026-04-20T07:28:18.700Z",
"uptime": 123
}{
"error": {
"code": "missing_api_key",
"message": "Provide an API key using Authorization: Bearer <api_key>.",
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
"details": {
"validationErrors": [
{
"field": "query-string.limit",
"location": "query-string",
"expected": [
"limit must not be greater than 100"
]
}
]
}
}
}Read public API data freshness
Returns the latest ready and latest indexed/scheduled global snapshot dates for public API reach-history data.
Response Body
application/json
application/json
curl -X GET "https://api.trendtrack.io/v1/system/freshness"{
"status": "ok",
"data": {
"latestReadyDate": "2026-04-23",
"latestScheduledDate": "2026-04-24",
"dataFreshnessLagDays": 1,
"generatedAt": "2026-04-24T14:42:14.123Z"
}
}{
"error": {
"code": "missing_api_key",
"message": "Provide an API key using Authorization: Bearer <api_key>.",
"requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
"details": {
"validationErrors": [
{
"field": "query-string.limit",
"location": "query-string",
"expected": [
"limit must not be greater than 100"
]
}
]
}
}
}