Twitter post monitor status & live engagement

{
  "id": "31",
  "postId": "2104984505677430978",
  "postUrl": "https://x.com/xquik/status/2104984505677430978",
  "authorId": "1661816432185823232",
  "authorUsername": "xquik",
  "authorName": "Xquik",
  "text": "We shipped post monitors.",
  "postedAt": "2026-09-29T17:19:49.000Z",
  "eventTypes": [
    "post.reply.new"
  ],
  "isActive": true
}

{
  "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}

Twitter post monitor status & live engagement

curl --request GET \
  --url https://xquik.com/api/v1/monitors/posts/{id} \
  --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}', 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}"

	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))

}

{
  "id": "<string>",
  "name": "<string>",
  "postId": "<string>",
  "postUrl": "<string>",
  "authorId": "<string>",
  "authorUsername": "<string>",
  "authorName": "<string>",
  "text": "<string>",
  "postedAt": "<string>",
  "eventTypes": [
    "<string>"
  ],
  "isActive": true,
  "createdAt": "<string>",
  "nextBillingAt": "<string>",
  "pausedReason": "<string>",
  "pausedAt": "<string>",
  "metrics": {}
}

Read 1 post monitor by ID. Use it to check live metrics, the pause state, or the event types before you change alerts.

Free. This endpoint does not consume credits.

curl https://xquik.com/api/v1/monitors/posts/31 \
  -H "x-api-key: xq_YOUR_KEY_HERE" |
  jq -c '{
    post_monitor_id: .id,
    post_url: .postUrl,
    text: .text,
    is_active: .isActive,
    paused_reason: (.pausedReason // null),
    views: .metrics.views.current,
    likes: .metrics.likes.current,
    like_gain: .metrics.likes.gain
  }'

const monitorId = "31";
const response = await fetch(`https://xquik.com/api/v1/monitors/posts/${monitorId}`, {
  headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
});
const monitor = await response.json();
const state = {
  post_monitor_id: monitor.id,
  post_url: monitor.postUrl,
  text: monitor.text,
  is_active: monitor.isActive,
  paused_reason: monitor.pausedReason ?? null,
  views: monitor.metrics.views.current,
  likes: monitor.metrics.likes.current,
  like_gain: monitor.metrics.likes.gain,
};
process.stdout.write(`${JSON.stringify(state)}\n`);

import json
import requests

monitor_id = "31"
response = requests.get(
    f"https://xquik.com/api/v1/monitors/posts/{monitor_id}",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
)
monitor = response.json()
state = {
    "post_monitor_id": monitor["id"],
    "post_url": monitor["postUrl"],
    "text": monitor["text"],
    "is_active": monitor["isActive"],
    "paused_reason": monitor.get("pausedReason"),
    "views": monitor["metrics"]["views"]["current"],
    "likes": monitor["metrics"]["likes"]["current"],
    "like_gain": monitor["metrics"]["likes"]["gain"],
}
print(json.dumps(state))

Check 1 monitor before you act

Question	Field	Next step
Is it the right post?	`postUrl` & `text`	`text` is the newest version Xquik read.
Can it send events?	`isActive` & `pausedReason`	Resume with `isActive: true` once X shows it.
Which events does it send?	`eventTypes`	Match your webhook subscriptions to this list.
How did engagement move?	`metrics.*.gain`	Read hourly buckets for the trend.

pausedReason is insufficient_credits when the balance could not pay an hour. Add credits, then resume. The other 3 reasons mean X stopped showing the post. Read stored events with GET /events?postMonitorId={id}. Read hourly values with Post Monitor Metrics.

Path parameters

string

required

The post monitor ID. Create Post Monitor & List Post Monitors return it.

Headers

string

required

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

Response

200 OK

string

Unique post monitor ID.

string

Your label for the monitor, when set.

string

ID of the post you gave.

string

Link to the post.

string

Permanent X user ID of the post’s author.

string

Username of the post’s author.

string

Display name of the post’s author.

string

Text of the newest version Xquik read.

string

ISO 8601 time X published the post.

string[]

Post event types this monitor sends.

boolean

Whether the monitor is active.

string

ISO 8601 creation timestamp.

string

Next hourly credit charge time.

string

insufficient_credits, x_post_deleted, x_post_protected or x_post_unavailable. Absent when active or paused by you.

string

When Xquik paused the monitor.

object

views, likes, retweets, replies, quotes & bookmarks. Each holds current & gain since tracking began. Both are null when X shows no count.

400 Invalid input

The monitor ID is not valid.

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.

{
  "id": "31",
  "postId": "2104984505677430978",
  "postUrl": "https://x.com/xquik/status/2104984505677430978",
  "authorId": "1661816432185823232",
  "authorUsername": "xquik",
  "authorName": "Xquik",
  "text": "We shipped post monitors.",
  "postedAt": "2026-09-29T17:19:49.000Z",
  "eventTypes": [
    "post.reply.new"
  ],
  "isActive": true
}

{
  "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
}

Twitter post monitor status & live engagement

curl --request GET \
  --url https://xquik.com/api/v1/monitors/posts/{id} \
  --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}', 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}"

	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))

}

{
  "id": "<string>",
  "name": "<string>",
  "postId": "<string>",
  "postUrl": "<string>",
  "authorId": "<string>",
  "authorUsername": "<string>",
  "authorName": "<string>",
  "text": "<string>",
  "postedAt": "<string>",
  "eventTypes": [
    "<string>"
  ],
  "isActive": true,
  "createdAt": "<string>",
  "nextBillingAt": "<string>",
  "pausedReason": "<string>",
  "pausedAt": "<string>",
  "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

Twitter post monitor status & live engagement

Check 1 monitor before you act

Path parameters

Headers

Response

200 OK

400 Invalid input

401 Unauthenticated

404 Not found

429 Rate limited

​Check 1 monitor before you act

​Path parameters

​Headers

​Response

​200 OK

​400 Invalid input

​401 Unauthenticated

​404 Not found

​429 Rate limited

Check 1 monitor before you act

Path parameters

Headers

Response

200 OK

400 Invalid input

401 Unauthenticated

404 Not found

429 Rate limited