Skip to main content
xurl is a curl-like command-line tool for the X API. It handles OAuth authentication automatically so you can make API requests without manually managing tokens or signing requests.

GitHub repository

Source code, releases, and documentation.

​
Installation

Install with Go, or download a pre-built binary from releases. 
go install github.com/xdevplatform/xurl@latest

​
Setup

Authorize xurl with your X API credentials on first use: 
xurl auth
This opens a browser-based OAuth flow. Once authorized, xurl stores your tokens locally so you don’t need to authenticate again.

​
Usage

​
Raw API requests

Use xurl like curl — it handles auth headers automatically: 
# Look up a user
xurl /2/users/by/username/xdevelopers

# Search recent posts
xurl "/2/tweets/search/recent?query=from:xdevelopers&max_results=10"

# Create a post
xurl -X POST /2/tweets -d '{"text": "Hello from xurl!"}'

​
Shortcut commands

xurl includes built-in shortcuts for common operations: 
# Look up a user by username
xurl user xdevelopers

# Search recent posts
xurl search "X API"

# Post a tweet
xurl post "Hello from xurl!"

​
Why use xurl?

Featurecurlxurl
AuthenticationManual OAuth header setupAutomatic — just run xurl auth once
Token managementYou handle refresh/rotationBuilt-in token storage and refresh
API shortcutsFull URL requiredShorthand commands for common tasks
Request signingManual OAuth 1.0a signingAutomatic for all requests

​
Using xurl with AI agents

xurl includes a SKILL.md file that describes its capabilities in a machine-readable format. AI agents can use this to understand how to invoke xurl commands on your behalf. 
npx skills add https://github.com/xdevplatform/xurl

Make your first request

Get started with the X API using cURL or SDKs.

API Playground

Test endpoints locally with mock data — no API credits needed.