Twitter post monitor updates & engagement alerts

{
  "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": "post_unavailable",
  "message": "The author deleted this post. Delete this monitor."
}

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

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

PATCH

monitors

posts

{id}

Twitter post monitor updates & engagement alerts

curl --request PATCH \
  --url https://xquik.com/api/v1/monitors/posts/{id} \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "eventTypes": [
    "<string>"
  ],
  "name": {},
  "isActive": true
}
'

import requests

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

payload = {
    "eventTypes": ["<string>"],
    "name": {},
    "isActive": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({eventTypes: ['<string>'], name: {}, isActive: true})
};

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"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"eventTypes\": [\n    \"<string>\"\n  ],\n  \"name\": {},\n  \"isActive\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

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

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

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "eventTypes": [
    "<string>"
  ],
  "isActive": true,
  "nextBillingAt": "<string>",
  "metrics": {}
}

Change a post monitor’s label, event types or active state. The tracked post stays the same, so the monitor ID & its history stay usable.

Free. This endpoint does not consume credits. Active monitors bill 30 credits per hour.

curl -X PATCH https://xquik.com/api/v1/monitors/posts/31 \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "eventTypes": ["post.reply.new", "post.likes.changed"],
    "isActive": true
  }' |
  jq -c '{
    post_monitor_id: .id,
    event_types: .eventTypes,
    is_active: .isActive,
    next_billing_at: .nextBillingAt
  }'

const monitorId = "31";
const response = await fetch(`https://xquik.com/api/v1/monitors/posts/${monitorId}`, {
  method: "PATCH",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    eventTypes: ["post.reply.new", "post.likes.changed"],
    isActive: true,
  }),
});
const monitor = await response.json();
const state = {
  post_monitor_id: monitor.id,
  event_types: monitor.eventTypes,
  is_active: monitor.isActive,
  next_billing_at: monitor.nextBillingAt,
};
process.stdout.write(`${JSON.stringify(state)}\n`);

import json
import requests

monitor_id = "31"
response = requests.patch(
    f"https://xquik.com/api/v1/monitors/posts/{monitor_id}",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    json={
        "eventTypes": ["post.reply.new", "post.likes.changed"],
        "isActive": True,
    },
)
monitor = response.json()
state = {
    "post_monitor_id": monitor["id"],
    "event_types": monitor["eventTypes"],
    "is_active": monitor["isActive"],
    "next_billing_at": monitor["nextBillingAt"],
}
print(json.dumps(state))

Pause & resume a post monitor

Send isActive: false to stop reads, events & hourly billing. The monitor & its history stay. Send isActive: true to resume. Xquik reads the post first. While X hides the post, the route answers 409 & changes nothing. The monitor stays paused & costs nothing. A resumed monitor reports nothing from its pause. Its first read sets the new starting point. To track a different post, create a new monitor. Then delete or pause the old one.

Path parameters

string

required

The post monitor ID.

Headers

string

required

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

string

required

Must be application/json.

Body

Send at least 1 field.

string[]

Post event types to send, 1 to 10. Replaces the current list. Valid types are post.reply.new, post.quote.new, post.likes.changed, post.retweets.changed, post.replies.changed, post.quotes.changed, post.bookmarks.changed, post.views.changed, post.edited & post.deleted.

string | null

New label, 1 to 80 characters. Send null to remove it.

boolean

false pauses the monitor. true resumes it once X shows the post.

Response

200 OK

Returns the updated monitor, shaped like the Get Post Monitor response.

string

Unique post monitor ID.

string[]

Post event types this monitor sends.

boolean

Whether the monitor is active.

string

Next hourly credit charge time.

object

The 6 metrics, each with current & gain since tracking began.

400 Invalid input

No field to change, or a field is invalid. The message says what to fix.

401 Unauthenticated

Missing or invalid API key.

404 Not found

No post monitor has this ID on your account.

409 Post unavailable

X still hides the post, so the monitor stays paused. reason is deleted, protected or author_suspended when X names it.

429 Rate limited

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

502 X unavailable

X failed the read while resuming. Retry after a short wait.

503 Busy

Xquik is busy right now. Wait for Retry-After, then retry.

{
  "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": "post_unavailable",
  "message": "The author deleted this post. Delete this monitor."
}

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

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Twitter post monitor updates & engagement alerts

curl --request PATCH \
  --url https://xquik.com/api/v1/monitors/posts/{id} \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "eventTypes": [
    "<string>"
  ],
  "name": {},
  "isActive": true
}
'

import requests

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

payload = {
    "eventTypes": ["<string>"],
    "name": {},
    "isActive": True
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({eventTypes: ['<string>'], name: {}, isActive: true})
};

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"
	"strings"
	"net/http"
	"io"
)

func main() {

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

	payload := strings.NewReader("{\n  \"eventTypes\": [\n    \"<string>\"\n  ],\n  \"name\": {},\n  \"isActive\": true\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

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

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

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "eventTypes": [
    "<string>"
  ],
  "isActive": true,
  "nextBillingAt": "<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 updates & engagement alerts

Pause & resume a post monitor

Path parameters

Headers

Body

Response

200 OK

400 Invalid input

401 Unauthenticated

404 Not found

409 Post unavailable

429 Rate limited

502 X unavailable

503 Busy

​Pause & resume a post monitor

​Path parameters

​Headers

​Body

​Response

​200 OK

​400 Invalid input

​401 Unauthenticated

​404 Not found

​409 Post unavailable

​429 Rate limited

​502 X unavailable

​503 Busy

Pause & resume a post monitor

Path parameters

Headers

Body

Response

200 OK

400 Invalid input

401 Unauthenticated

404 Not found

409 Post unavailable

429 Rate limited

502 X unavailable

503 Busy