Twitter post monitor list & tracked post metrics

{
  "monitors": [],
  "total": 0,
  "hasMore": false
}

{
  "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": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

GET

monitors

posts

Twitter post monitor list & tracked post metrics

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

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

fetch('https://xquik.com/api/v1/monitors/posts', 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"

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

}

{
  "monitors": [
    {}
  ],
  "total": 123,
  "hasMore": true,
  "nextCursor": "<string>"
}

List every post monitor on your account. Each row holds the post, its author, its event types & its 6 metrics. Each metric shows its current value & its gain since tracking began.

Free. This endpoint does not consume credits.

curl "https://xquik.com/api/v1/monitors/posts?limit=50" \
  -H "x-api-key: xq_YOUR_KEY_HERE" |
  jq -c '.monitors[] | {
    post_monitor_id: .id,
    post_url: .postUrl,
    author_username: .authorUsername,
    is_active: .isActive,
    paused_reason: (.pausedReason // null),
    likes: .metrics.likes.current,
    like_gain: .metrics.likes.gain
  }'

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

import json
import requests

response = requests.get(
    "https://xquik.com/api/v1/monitors/posts",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    params={"limit": 50},
)
page = response.json()
for monitor in page["monitors"]:
    row = {
        "post_monitor_id": monitor["id"],
        "post_url": monitor["postUrl"],
        "author_username": monitor["authorUsername"],
        "is_active": monitor["isActive"],
        "paused_reason": monitor.get("pausedReason"),
        "likes": monitor["metrics"]["likes"]["current"],
        "like_gain": monitor["metrics"]["likes"]["gain"],
    }
    print(json.dumps(row))

Each example prints 1 row per monitor. Pass nextCursor as cursor until hasMore is false.

Review every tracked post

Question	Field	Next step
Which post is this?	`postUrl` & `authorUsername`	Open the post before you change the monitor.
Is it still billing?	`isActive` & `nextBillingAt`	Pause monitors nobody reads.
Did Xquik pause it?	`pausedReason`	Add credits, or delete monitors of deleted posts.
How far has engagement moved?	`metrics.*.gain`	Read hourly gains for the trend.

A monitor paused with insufficient_credits resumes once you add credits & turn it on. x_post_deleted, x_post_protected & x_post_unavailable mean X stopped showing the post.

Headers

string

required

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

Query parameters

integer

Monitors per page, from 1 to 200. Default 200.

string

The previous page’s nextCursor. The after alias also works.

Response

200 OK

object[]

Post monitors, each shaped like the Get Post Monitor response.

number

Post monitors on this page.

boolean

true when another page exists.

string

Cursor for the next page. Present when hasMore is true.

400 Invalid input

limit or cursor is invalid. Send a nextCursor value unchanged.

401 Unauthenticated

Missing or invalid API key.

429 Rate limited

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

{
  "monitors": [],
  "total": 0,
  "hasMore": false
}

{
  "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": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Twitter post monitor list & tracked post metrics

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

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

fetch('https://xquik.com/api/v1/monitors/posts', 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"

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

}

{
  "monitors": [
    {}
  ],
  "total": 123,
  "hasMore": true,
  "nextCursor": "<string>"
}

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 list & tracked post metrics

Review every tracked post

Headers

Query parameters

Response

200 OK

400 Invalid input

401 Unauthenticated

429 Rate limited

​Review every tracked post

​Headers

​Query parameters

​Response

​200 OK

​400 Invalid input

​401 Unauthenticated

​429 Rate limited

Review every tracked post

Headers

Query parameters

Response

200 OK

400 Invalid input

401 Unauthenticated

429 Rate limited