X

​

Coverage

A Watch on X polls a search query on your interval and keeps every tweet that matches. The query is X search syntax, so the same operators you would use in the app narrow a Watch: from:handle, -filter:replies, "exact phrase", lang:fr. A search can carry several terms at once, OR’d into one upstream request at one tick’s cost — see Watches.

​

What an event carries

Each match is delivered as a tweet.created event with the full tweet: text, metrics, the author, and the media and links it carried. webhook_url is optional — without it the Watch still records every match, readable through GET /v1/x/watches/{id}/events. See Webhooks. The event feed is cursor-paginated: pass the opaque nextCursor back unchanged on the next request.

​

Verification fields

Author objects expose two separate flags:

• verified — legacy checkmark (government/brand/org verification before X Premium)
• isBlueVerified — X Premium / Blue subscription badge

Read both fields. They are not interchangeable.

​

Limits

An author’s likes are heavily restricted by X and are not a Watch criterion. Deleted and protected tweets stop appearing in matches rather than being retracted from a feed you have already read.