Intelligence

X/Twitter Monitor

Watch an X/Twitter account or keyword query in real time: new tweets, replies, quotes, mentions, hashtags, and profile changes, delivered to your agent by free polling or HMAC-signed webhooks. Prepaid by the hour with a hard stop at expiry — no open-ended billing. The way to track a brand, competitor, or topic without re-polling paid reads.

post/api/tools/x_monitor

Request

  • Base URL: https://twitr.sh
  • URL: https://twitr.sh/api/tools/x_monitor
  • Auth: none declared. Required headers: Idempotency-Key

Headers

Idempotency-Keystring required

Unique key per logical action. A retry with the same key replays the original result (10-minute window) instead of acting or charging twice.

Request body

action'create' | 'extend' required

Create a new monitor or extend an existing one.

type'account' | 'keyword'

Monitor kind (create). Inferred from username/query when omitted.

usernamestring

X handle to monitor, without @ (create, type=account).

querystring

X search query to monitor (create, type=keyword).

eventTypesstring[]

Event types to receive (default: all applicable). Post events (tweet.) work for any monitor; profile-change events (profile..changed) apply to ACCOUNT monitors only.

hoursinteger

Prepaid hours to purchase (default 1).

monitorIdstring

Monitor to extend (extend only).

Response

Result dataset.

itemsobject[] required

Array of returned items. Shape varies per tool — see each tool's documentation.

runIdstring

Run ID for debugging/audit.

durationinteger

Run duration in seconds.

Changes

No recorded changes to this operation across all 1 revision of this API.