Hourly Twitter post metrics & engagement gains

{
  "hours": 1,
  "buckets": [
    {
      "at": "2026-10-22T11:00:00.000Z",
      "metrics": {
        "views": {
          "value": 541600,
          "gain": 500
        },
        "likes": {
          "value": 1890,
          "gain": 5
        },
        "retweets": {
          "value": 112,
          "gain": 0
        },
        "replies": {
          "value": 86,
          "gain": 1
        },
        "quotes": {
          "value": 87,
          "gain": 0
        }
      }
    }
  ]
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "forbidden",
  "message": "This API key calls paid X read routes only, such as GET /api/v1/x/tweets/search. Create a Full access key at dashboard.xquik.com/account?tab=api-keys to call this route."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

GET

monitors

posts

{id}

metrics

Hourly Twitter post metrics & engagement gains

curl --request GET \
  --url https://xquik.com/api/v1/monitors/posts/{id}/metrics \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/monitors/posts/{id}/metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/monitors/posts/{id}/metrics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "hours": 123,
  "buckets": [
    {}
  ],
  "buckets[].at": "<string>",
  "buckets[].metrics": {}
}

Read a monitored post’s metrics hour by hour. Each bucket holds every metric’s value at the hour’s end & its gain over that hour.

Free. This endpoint does not consume credits.

curl "https://xquik.com/api/v1/monitors/posts/31/metrics?hours=24" \
  -H "x-api-key: xq_YOUR_KEY_HERE" |
  jq -c '.buckets[] | {
    hour: .at,
    views: .metrics.views.value,
    view_gain: .metrics.views.gain,
    likes: .metrics.likes.value,
    like_gain: .metrics.likes.gain
  }'

const monitorId = "31";
const response = await fetch(
  `https://xquik.com/api/v1/monitors/posts/${monitorId}/metrics?hours=24`,
  { headers: { "x-api-key": "xq_YOUR_KEY_HERE" } },
);
const history = await response.json();
for (const bucket of history.buckets) {
  const row = {
    hour: bucket.at,
    views: bucket.metrics.views.value,
    view_gain: bucket.metrics.views.gain,
    likes: bucket.metrics.likes.value,
    like_gain: bucket.metrics.likes.gain,
  };
  process.stdout.write(`${JSON.stringify(row)}\n`);
}

import json
import requests

monitor_id = "31"
response = requests.get(
    f"https://xquik.com/api/v1/monitors/posts/{monitor_id}/metrics",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    params={"hours": 24},
)
history = response.json()
for bucket in history["buckets"]:
    row = {
        "hour": bucket["at"],
        "views": bucket["metrics"]["views"]["value"],
        "view_gain": bucket["metrics"]["views"]["gain"],
        "likes": bucket["metrics"]["likes"]["value"],
        "like_gain": bucket["metrics"]["likes"]["gain"],
    }
    print(json.dumps(row))

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 30 days of history, which matches the 720-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, as for views on old posts.

Path parameters

string

required

The post monitor ID.

Query parameters

integer

Hours to return, from 1 to 720. Default 12.

Headers

string

required

Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Response

200 OK

integer

Number of hours returned.

object[]

Hourly buckets, oldest first.

string

ISO 8601 start of the hour.

object

views, likes, retweets, replies, quotes & bookmarks. Each holds value at the hour’s end & gain over that hour.

400 Invalid input

hours is not a whole number from 1 to 720.

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.

Related. Get Post Monitor, List Post Monitors, or List Events.

{
  "hours": 1,
  "buckets": [
    {
      "at": "2026-10-22T11:00:00.000Z",
      "metrics": {
        "views": {
          "value": 541600,
          "gain": 500
        },
        "likes": {
          "value": 1890,
          "gain": 5
        },
        "retweets": {
          "value": 112,
          "gain": 0
        },
        "replies": {
          "value": 86,
          "gain": 1
        },
        "quotes": {
          "value": 87,
          "gain": 0
        }
      }
    }
  ]
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "forbidden",
  "message": "This API key calls paid X read routes only, such as GET /api/v1/x/tweets/search. Create a Full access key at dashboard.xquik.com/account?tab=api-keys to call this route."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Hourly Twitter post metrics & engagement gains

curl --request GET \
  --url https://xquik.com/api/v1/monitors/posts/{id}/metrics \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/monitors/posts/{id}/metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/monitors/posts/{id}/metrics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "hours": 123,
  "buckets": [
    {}
  ],
  "buckets[].at": "<string>",
  "buckets[].metrics": {}
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Hourly Twitter post metrics & engagement gains

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

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

401 Unauthenticated

404 Not found

429 Rate limited

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

​Path parameters

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid input

​401 Unauthenticated

​404 Not found

​429 Rate limited

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

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

401 Unauthenticated

404 Not found

429 Rate limited