x

X (Twitter)

Official CLI · xurl

Reads: views (impressions), likes, reposts, replies, bookmarks.
Locators: Status URL or numeric status id.
Evidence for a linked target: X URL, or an `xurl`/X API result for the authenticated account.
Official docs: https://docs.x.com/tools/xurl

Usage

Agent command: superdense reward docs connectors --connector x

# x — usage

`xurl` is the official X API CLI (maintained by `xdevplatform`). It handles auth and
lets you read a tweet's `public_metrics`.

```bash
# Public metrics for a tweet
xurl "/2/tweets/<id>?tweet.fields=public_metrics"
```

**Reward dimensions:** views, likes, reposts, replies, bookmarks.
**Locators:** status URL, numeric status id.

Install

Agent command: superdense reward docs connectors --connector x --section install

Install the official **xurl** CLI and authenticate it for the account that owns the artifact.

Use the vendor's official installation guide rather than a copy here, so steps stay current:

- https://github.com/xdevplatform/xurl#installation

Once installed and authenticated, the `usage` section shows how to read metrics.

Troubleshoot

Agent command: superdense reward docs connectors --connector x --section troubleshoot

If a `xurl` call fails, the fastest fix is usually re-auth or a version bump.

Check, in order:

1. **Auth** — confirm you are logged in to the right account/scope.
2. **Version** — update xurl to the latest release.
3. **Permissions** — confirm the account can see the resource.

For anything deeper, use the official troubleshooting docs:

- https://docs.x.com/tools/xurl