Skip to main content
GET https://xquik.com/api/v1/monitors/posts/{id}/metrics Read a monitored post’s metrics hour by hour. Each bucket holds every metric’s value at the hour’s end. It also holds each metric’s gain over that hour.
Free. This endpoint does not consume credits.

How do I chart a tweet’s engagement over time?

Buckets come oldest first, 1 per hour. The last bucket is the current hour, so its values keep moving. Hours before tracking began carry the starting values with a gain of 0. Xquik keeps 730 days of history, which matches the 17,520-hour limit. Sum the gains for a period’s total. Use the last bucket’s value for the current count. A value & its gain are null when X shows no count. Views on old posts are one example.

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

hours is not a whole number from 1 to 17,520.

401 Unauthenticated

Missing or invalid API key.

404 Not found

No post monitor has this ID on your account.

429 Rate limited

Too many requests. Wait for the Retry-After header before retrying.

Response examples

200 example

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 404 { "error": "not_found", "message": "Resource not found." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }