visual documentation of Twitter API

https://api.twitter.com/1.1
/statuses
GET
GET
/statuses/mentions_timeline.json
count
200
since_id
12345
max_id
54321
trim_user
true
contributor_details
true
include_entities
false
include_rts
1
/statuses/user_timeline.json
user_id
12345
screen_name
noradio
since_id
12345
count
200
max_id
54321
trim_user
exclude_replies
contributor_details
include_rts
GET
GET
GET
POST
POST
POST
GET
POST
false
POST
contributor_details
true
include_entities
false
/statuses/retweets_of_me.json
12345
slug
list-slug
user_id
12345
screen_name
noradio
count
5
since_id
12345
max_id
54321
cursor
12893764510938
include_entities
false
include_entities
true
skip_status
true
list_id
slug
id
123
include_entities
false
/direct_messages.json
owner_id
123
true
/statuses/update.json
POST
true
123
/lists/members/destroy.json
Twitter%20API
page
3
count
5
include_entities
false
GET
list_slug
/lists/members/create_all.json
user_id
111,222,333
screen_name
noradio,twitterapi,mls
list_id
12345
slug
list_slug
owner_screen_name
MLS
owner_id
123
GET
GET
/lists/members/create.json
/users/contributees.json
user_id
12345
screen_name
noradio
include_entities
false
skip_status
true
/users/contributors.json
screen_name
noradio
user_id
111,222,333
display_coordinates
true
cursor
12893764510938
screen_name
noradio,twitterapi,mls
trim_user
true
list_id
12345
screen_name
noradio
media_ids
1234,5678,9012
slug
list_slug
user_id
12345
/statuses/update_with_media.json
user_id
12345
status
hello world
include_entities
false
media[]
raw bytes or base64
skip_status
true
possibly_sensitive
true
in_reply_to_status_id
12345
lat
37.7821120598956
long
-122.400612831116
place_id
df51dec6f4ee2b2c
POST
true
/blocks/destroy.json
screen_name
noradio
user_id
12345
include_entities
false
skip_status
true
GET
99530515043983360
https%3A%2F
%2Ftwitter.com%2F%23!
%2Ftwitter%2Fstatus
%2F99530515043983360
POST
POST
noradio
count
100
cursor
-1
filter_to_owned_lists
true
12345
GET
/activity/about_me.json
list_id
12345
screen_name
barackobama
slug
list-slug
123
123abc
user_id
123456789
force_login
true
screen_name
noradio
true
skip_status
true
list_id
12345
slug
list-slug
align
left,right,center,none
count
50
related
twitterapi,twittermedia,
twitter
filters
include_cards
1
fr
owner_screen_name
MLS
include_descendent_reply
_count
true
owner_id
123
include_entities
1
include_media_features
true
list_id
12345
include_my_retweet
1
slug
list_slug
include_user_entities
1
owner_screen_name
MLS
/statuses/lookup.json
latest_results
true
owner_id
123
id
20,43265,6548536401920
model_version
7
include_entities
false
since_id
trim_user
true
map
true
/statuses/:id/activity/summary.json
GET
iPhone-8
id
1
contributor_details
1
exclude
"hashtags"
include_cards
1
include_descendent_reply
_count
true
include_entities
1
include_media_features
true
include_my_retweet
1
include_user_entities
true
cards_platform
iPhone-8
contributor_details
1
count
50
include_cards
1
include_entities
1
include_media_features
GET
/lists/subscribers/destroy.json
list_id
12345
slug
list_slug
/trends/place.json
cards_platform
GET
/lists/subscribers/create.json
POST
owner_screen_name
MLS
owner_id
123
slug
/trends/place.json
lat
37.781157
long
-122.400612831116
POST
12345
list_slug
owner_screen_name
MLS
owner_id
123
/lists/update.json
name
Goonies
/trends/personalized.json
mode
"public" or "private"
GET
/trends/timeline.json
description
for%20life
list_id
12345
slug
list_slug
/conversation/show/:id.json
GET
/conversation/show.json
cards_platform
true
contributor_details
MLS
owner_screen_name
GET
owner_id
POST
Goonies
mode
1
"public" or "private"
include_my_retweet
1
count
20
clude_user_entities
true
id
482705139862863872
screen_name
barackobama
include_cards
1
/statuses/retweeted_by.json
include_descendent_reply
_count
true
?
include_entities
1
owner_screen_name
MLS
include_media_features
true
owner_id
123
include_my_retweet
1
include_user_entities
true
?
/statuses/report_spam.json
tweet_id
1234
report_as
?
/statuses/favorited_by.json
?
?
GET
resources
q
@noradio
geocode
37.78115,-122.39872,1mi
lang
eu
locale
ja
result_type
mixed, recent, popular
count
100
until
2012-09-01
since_id
12345
max_id
54321
include_entities
false
callback
processTweets
/search/tweets.json
q
euro
result_type
all
send_error_codes
true
/search/universal.json
q
abc
/search/typeahead.json
?
abc
GET
/application/rate_limit_status.json
statuses,friends,trends,
help
GET
/translations
GET
/translations/lookup.json
/promoted_content
GET
/promoted_content/log.json
/followers
GET
GET
/followers/list.json
/followers/vit/list.json
/trends
GET
/trends/available.json
GET
/trends/plus.json
GET
/trends/timeline.json
GET
POST
POST
POST
12345
slug
list-slug
123456789
screen_name
noradio
count
1000
cursor
-1
user_id
123456789
screen_name
noradio
count
1000
cursor
-1
POST
/help/experiments.json
GET
/help/settings.json
true
/user.json
token to revoke
POST
/guest/activate.json
POST
?
/signup/sms_verify_complete.json
?
POST
/media
/media/media_tags/delete.json
GET
1234
/friends
GET
/friends/ids.json
user_id
12345
screen_name
noradio
cursor
12893764510938
stringify_ids
true
count
2048
GET
/friends/list.json
user_id
screen_name
noradio
cursor
12893764510938
count
/geo/search.json
POST
/graph/app/register.json
discoverable_by_email
0
lang
en
with
"user" or "following"
name
Toto
replies
"all"
password
12345
stringify_friends_ids
true
screen_name
toto123
/beta
/trends
GET
/beta/timelines/custom/list.json
GET
/trends/1.json
GET
/beta/timelines/timeline.json
GET
/trends/available.json
/beta/timelines/custom/update.json
granularity
city
accuracy
5ft
POST
/beta/timelines/custom/destroy.json
max_results
3
/beta/timelines/custom/add.json
contained_within
247f43d441defc03
POST
attribute:street_address
795%20Folsom%20St
POST
/beta/timelines/custom/remove.json
callback
optional
POST
/beta/timelines/custom/remove.json
POST
/beta/timelines/custom/follow.json
/geo/similar_places.json
lat
37.7821120598956
long
-122.400612831116
name
74.125.19.104
contained_within
247f43d441defc03%20HQ
attribute:street_address
795%20Folsom%20St
callback
optional
GET
POST
name
Twitter%20HQ
contained_within
247f43d441defc03
token
36179c9bf78835898ebf521
lat
37.7821120598956
long
-122.400612831116
/geo/places.json
?
POST
/beta/timelines/custom/unfollow.json
action
shown
prompt_id
1217
user_id
1234567
/device/install_referrer.json
GET
/device/operator_signup_info.json
cards_platform
iPhone-8
mcc
contributor_details
1
mnc
count
100
earned
true
include_cards
1
include_descendent_reply
_count
true
include_entities
1
include_media_features
true
include_my_retweet
1
include_user_entities
true
pc
true
Sunrise
since_id
1234567890
timezone
Europe/Zurich
/device/register.json
raw_phone_number
+41761234567
text_message
abcd
device/register_complete.json
phone_number
+41761234567
text_message
abcd
numeric_pin
1234
POST
/device/sms_verify_begin.json
POST
/device/sms_verify_complete.json
POST
/device/unregister.json
/contacts
POST
contacts/upload_and_match.json
/friendships/create.json
screen_name
noradio
user_id
12345
follow
true
/push_destinations
GET
POST
/friendships/destroy.json
screen_name
noradio
user_id
12345
GET
POST
/friendships/incoming.json
stringify_ids
true
cursor
12893764510938
screen_name
noradio
user_id
12345
/friendships/no_retweets/ids.json
true
/friendships/outgoing.json
stringify_ids
true
cursor
12893764510938
/push_destinations.json
/push_destinations/destroy.json
/push_destinations/device.json
push_destinations/remove.json
/dm
GET
/friendships/lookup.json
POST
/dm/conversation/:id.json
/dm/conversation/:id/add_participants.json
participant_ids
/dm/conversation/:id/delete.json
POST
/dm/conversation/:id/disable_notifications.json
POST
/dm/conversation/:id/enable_notifications.json
POST
/dm/conversation/:id/mark_read.json
last_read_event_id
/friendships/update.json
screen_name
noradio
user_id
12345
device
true
retweets
true
POST
/friendships/accept.json
POST
/friendships/cancel.json
POST
/friendships/create_all.json
POST
/friendships/deny.json
POST
/friendships/destroy_all.json
12345
POST
/friendships/show.json
POST
asd
/dm/permissions.json
recipient_ids
POST
12345
/dm/new.json
text
GET
12345
/dm/destroy.json
id
POST
asd
/dm/conversation/mark_read.json
last_seen_event_id
POST
12345
/dm/conversation/:id/update_name.json
name
POST
/jot
POST
/jot/client_event
lang
en
log
a big JSON array
/promoted_content
/promoted_content/log.json
12345
/dm/update_last_seen_event_id.json
last_seen_event_id
GET
/dm/user_inbox.json
GET
/dm/user_updates.json
https://api.twitter.com
/auth/1
/xauth_password.json
?
iso2_cc
12345
/statuses/friends.json
POST
GET
carrier_name
/timeline/dismiss.json
GET
/prompts/record_event.json
/device/token.json
POST
/statuses/followers.json
/prompts/suggest.json
GET
POST
GET
GET
/device
/timeline/home.json
/statuses
/beta/timelines/custom/show.json
/prompts
GET
/geo/place.json
include_user_entities
/graph/app/optout/update.json
pad
12345,67890,123789
POST
noradio
POST
adc
follow
Twitter%20HQ
target_screen_name
/graph/app/optout/status.json
/account/generate.json
0
query
false
POST
POST
geo_enabled
/beta/timelines/custom/create.json
20
/graph
/account/push_destinations/remove
true
POST
target_id
/friends/vit/list.json
POST
stall_warnings
74.125.19.104
false
GET
/account/push_destinations/device
[email protected]
ip
skip_status
/friends/vit/ids.json
GET
email
-122.400612831116
raffi
GET
/account/push_destinations/destroy.json
"length"
long
source_screen_name
/friends/following/list.json
POST
/account/push_destinations.json
delimited
37.7821120598956
42
GET
GET
/site.json
lat
3191321
POST
https://api.twitter.com/1
/account
optional
source_id
/friends/following/ids.json
https://tailfeather.twimg.com/prod/config.json
callback
12345
GET
GET
3
stringify_ids
GET
https://mobile.twitter.com/ios/decider.json
max_results
/friendships
/sms_verify_begin.json
GET
city
tweet_id
1234567890
https://mobile.twitter.com/i/config.json?client=ios
granularity
/timeline
/oauth2/invalidate_token
GET
CEST
query_type
"client_credentials"
red rectangle means usable in app. only. mode
time_zone
noradio
/oauth2/token
GET
5ft
oauth_verifier
GET
undocumented and unsupported API endpoint
accuracy
noradio
"read" or "write"
GET
true
x_auth_mode
x_auth_access_type
<- click to open documentation
send_error_codes
optional
URL or "oob"
GET
-122.400612831116
callback
oauth_callback
API endpoint
long
true
/oauth/request_token
sample value
37.7821120598956
x_auth_username
POST
optional param
lat
795%20Folsom%20St
?
GET
/geo/reverse_geocode.json
attribute:street_address
?
GET
df51dec6f4ee2b2c
123abc
/signup
POST
GET
x_auth_password
guest_token
/help/languages.json
GET
/oauth/access_token
/guest
/help/configuration.json
/help/tos.json
noradio
/discover/universal.json
/lists/ownerships.json
GET
screen_name
status_id
user_id
/help/privacy.json
true
GET
/lists/subscriptions.json
GET
force_login
/discover/nearby.json
/help
GET
123abc
GET
POST
list_id
GET
/discover
GET
GET
oauth_token
access_token
for%20life
/lists/show.json
GET
/oauth2
POST
/application
/search
/search/tweets.json
description
GET
POST
123
/lists/create.json
name
iPhone-8
GET
POST
/oauth/authorize
grant_type
GET
/conversation
GET
/lists/destroy.json
list_id
/trends/available.json
GET
stall_warnings
/site
/geo/id/:place_id.json
place_id
/oauth/authenticate
oauth_token
include_entities
/trends
GET
abcdef
/geo
/oauth
/lists/subscribers/show.json
noradio
123456789
true
true
screen_name
POST
connections
pc
iPhone-8
POST
token
/users/recommendations.json
true
owner_id
-122.7,36.8,-121.75,37.8
"user" or "following"
/account/push_destinations/cleanup.json
/users/send_invites_by_email.json
skip_status
1
true
/users/reverse_lookup.json
true
contributor_details
stringify_ids
GET
include_user_entities
true
12893764510938
/users/show/:id.json
true
omit_script
cursor
GET
include_entities
true
327473909412814850
/users/interests/topics.json
st-component
hide_thread
id
GET
display_location
cards_platform
/statuses/retweeters/ids.json
/users/interests/timelines.json
-1
MLS
delimited
with
POST
/users/report_spam.json
cursor
owner_screen_name
37.7821120598956
/account/push_destinations/device.json
/account/login_verification_request.json
twitter
GET
/lists/subscribers.json
locations
true
POST
fr
/users/suggestions/:slug/members.json
slug
POST
/activity/about_me/unread.json
325
true
screen_name
/activity/by_friends.json
cursor
GET
123456789
"the iphone"
stall_warnings
GET
GET
/users/suggestions.json
lang
GET
/activity
/statuses/oembed.json
user_id
track
"length"
/account/login_verification_enrollment.json
MLS
/lists/memberships.json
12345,67890,123789
delimited
GET
/users/suggestions/:slug.json
true
GET
follow
/user
GET
sample value
Configuration Endpoints
/statuses/filter.json
true
skip_status
noradio
/account/remove_profile_banner.json
true
stringify_friends_ids
df51dec6f4ee2b2c
screen_name
12
stall_warnings
37.7821120598956
place_id
true
offset_top
"length"
locations
false
/blocks/create.json
12
delimited
36B42F35-1308-47DD-8FBB
include_entities
POST
offset_left
1000
udid
list_slug
123
123
/users/profile_banner.json
slug
owner_id
height
count
"the iphone"
-122.400612831116
123
123
/statuses/firehose.json
track
long
12893764510938
width
true
1
37.7821120598956
cursor
base64 or raw image
stall_warnings
send_error_codes
lat
/statuses/retweet/:id.json
banner
"length"
true
fr
owner_screen_name
/account/update_profile_banner.json
delimited
skip_status
lang
POST
POST
mandatory param
parameters
/statuses/sample.json
"all"
12345
GET
GET
API endpoint
mutually exclusive
replies
list_id
/lists/members/destroy_all.json
GET
GET
3
twitter
123
/statuses
environment
slug
owner_id
/account/update_profile_background_image.json
https://stream.twitter.com/1.1
false
12345
Legend
GET
include_entities
noradio
MLS
multipart/form-data or base64 encoded file
noradio
user_id
by @nst021 / seriot.ch
First version: 2014-07-02 00:00
Current version: 2015-01-23 21:30
/media/upload.json
screen_name
screen_name
GET
POST
12345
123456789
GET
POST
/media
user_id
user_id
/blocks/list.json
POST
123456789
owner_screen_name
true
true
use
MLS
q
true
stringify_ids
include_entities
true
POST
/users/search.json
possibly_sensitive
/blocks/ids.json
"sms" or "none"
skip_status
GET
12345
GET
device
false
in_reply_to_status_id
POST
/account/update_delivery_device.json
/users/show.json
hello world
GET
it
include_entities
GET
status
/blocks
lang
include_entities
slug
/direct_messages/read.json
Europe/Copenhagen
true
/direct_messages/new.json
noradio
time_zone
tile
12345
screen_name
13
false
true
trim_user
end_sleep_time
true
list_id
12345
13
skip_status
54321
user_id
start_sleep_time
base64-encoded image
owner_id
POST
1
image
max_id
Meet me after school
sleep_time_enabled
noradio
noradio
text
1
screen_name
trim_user
123
POST
trend_location_woeid
true
123
id
/users/lookup.json
https://upload.twitter.com/1.1
/account/settings.json
include_entities
owner_id
POST
POST
12345
false
/statuses/destroy/:id.json
true
12345
user_id
include_entities
false
skip_status
user_id
noradio
5
include_entities
false
whiteleaf
screen_name
screen_name
false
include_entities
screen_name
123456789
12345
include_entities
I work at Twitter.
user_id
count
true
description
false
MLS
include_my_retweets
/account/update_profile.json
San Francisco, CA
include_entities
since_id
1270516771
com.apple.Preferences
location
com.apple.Preferences
user_id
id
application_id
/mutes/users/destroy.json
appliction_id
owner_screen_name
/direct_messages/destroy.json
/account/settings.json
http://project.ioni.st
123
owner_screen_name
POST
true
url
owner_id
3
true
skip_status
12345
1
page
trim_user
false
user_id
map
123
123
include_entities
Marcel Molina
MLS
id
id
com.apple.Preferences
name
owner_screen_name
/lists/members/show.json
application_id
whiteleaf
[email protected],[email protected]
5
587424932
POST
/account/verify_credentials.json
screen_name
/users
GET
GET
POST
/mutes/users/create.json
email
list-slug
id
true
list-slug
count
/statuses/show/:id.json
skip_status
phone
slug
POST
false
adc
54321
/direct_messages/show.json
include_entities
12345
/statuses/retweets/:id.json
GET
2
783214,6253282
max_id
5
cursor
user_id
12345
/direct_messages/sent.json
POST
/mutes/users/list.json
twitterapi,twitter
list_id
POST
POST
2
screen_name
12345
true
false
MLS
since_id
skip_status
include_user_entities
GET
owner_screen_name
/lists/members.json
/favorites/create.json
54321
false
GET
/favorites/destroy.json
max_id
/statuses/media_timeline.json
GET
list_id
false
GET
GET
true
include_entities
/statuses/:id/activity.json
GET
include_rts
12345
GET
GET
false
/favorites/list.json
GET
GET
/mutes/users/ids.json
cursor
/lists/statuses.json
include_entities
since_id
include_entities
true
50
count
GET
reverse
count
313006
100
true
noradio
id
count
trim_user
screen_name
234567890
/direct_messages
GET
12345
max_id
false
true
user_id
/saved_searches/destroy/:id.json
include_entities
exclude_replies
GET
123456789
/favorites
true
true
GET
/lists/list.json
Twitter API Visual
Documentation
/account
/mutes
since_id
54321
lang
GET
POST
sandwiches
max_id
hide_media
POST
query
true
true
/saved_searches/create.json
123
maxwidth
GET
POST
313006
id
url
GET
id
12345
id
GET
/saved_searches/show/:id.json
since_id
display_coordinates
GET
GET
/lists
GET
200
trim_user
GET
/saved_searches/list.json
count
id
POST
GET
/statuses/home_timeline.json
trim_user
GET
/saved_searches
12345
?