snippetbashTip

twurl — Curl-like command but tailored specifically for the Twitter API. More information: <https://github.c

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandbutcurlliketailoredclitwurl

Problem

How to use the twurl command: Curl-like command but tailored specifically for the Twitter API. More information: <https://github.com/twitter/twurl#getting-started>.

Solution

twurl — Curl-like command but tailored specifically for the Twitter API. More information: <https://github.com/twitter/twurl#getting-started>.

Authorize twurl to access a Twitter account:

twurl authorize {{[-c|--consumer-key]}} {{twitter_api_key}} {{[-s|--consumer-secret]}} {{twitter_api_secret}}

Make a GET request to an API endpoint:

twurl {{[-X|--request-method]}} GET {{twitter_api_endpoint}}

Make a POST request to an API endpoint:

twurl {{[-X|--request-method]}} POST {{[-d|--data]}} '{{endpoint_params}}' {{twitter_api_endpoint}}

Upload media to Twitter:

twurl {{[-H|--host]}} "{{twitter_upload_url}}" {{[-X|--request-method]}} POST "{{twitter_upload_endpoint}}" {{[-f|--file]}} "{{path/to/media.jpg}}" {{[-F|--file-field]}} "media"

Access a different Twitter API host:

twurl {{[-H|--host]}} {{twitter_api_url}} {{[-X|--request-method]}} GET {{twitter_api_endpoint}}

Create an alias for a requested resource:

twurl alias {{alias_name}} {{resource}}

Code Snippets

Authorize `twurl` to access a Twitter account

twurl authorize {{[-c|--consumer-key]}} {{twitter_api_key}} {{[-s|--consumer-secret]}} {{twitter_api_secret}}

Make a GET request to an API endpoint

twurl {{[-X|--request-method]}} GET {{twitter_api_endpoint}}

Make a POST request to an API endpoint

twurl {{[-X|--request-method]}} POST {{[-d|--data]}} '{{endpoint_params}}' {{twitter_api_endpoint}}

Upload media to Twitter

twurl {{[-H|--host]}} "{{twitter_upload_url}}" {{[-X|--request-method]}} POST "{{twitter_upload_endpoint}}" {{[-f|--file]}} "{{path/to/media.jpg}}" {{[-F|--file-field]}} "media"

Access a different Twitter API host

twurl {{[-H|--host]}} {{twitter_api_url}} {{[-X|--request-method]}} GET {{twitter_api_endpoint}}

Context

tldr-pages: common/twurl

Revisions (0)

No revisions yet.