Home / X API Blog / Helpful tools

xURL — cURL for X

Helpful tools

xURL is a CLI tool specifically designed for interfacing with the X API.

Some key features include:

  • URL shortening
  • Authentication handling
  • Webhook testing via ngrok

You can check out the full project, including the README, here: github.com/xdevplatform/xurl

Quick Start

Install the tool with one curl command:

curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | sudo bash

Register your auth token:

xurl auth app --bearer-token YOUR_BEARER_TOKEN

And make requests:

xurl --auth app /2/tweets/20
User auth

For user (non–app-only) requests, xurl selects the credential profile with --auth oauth2 (OAuth 2.0 user context) or --auth oauth1 (OAuth 1.0a user access), depending on how you registered tokens — not a separate --auth user flag.

Check out the xurl GitHub README for further tutorials. I'll be using xurl in all sample commands in follow-on sections of this blog.

Previous Introduction