{"openapi":"3.2.0","info":{"title":"X (formerly Twitter) API","description":"X (formerly Twitter) public and private data API for search, posts (Tweets), users, followers, images, media and more.","version":"1.0.0"},"servers":[{"url":"https://twitter.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Explore"},{"name":"Tweet"},{"name":"User"},{"name":"Misc"},{"name":"List"}],"paths":{"/AutoComplete/":{"get":{"operationId":"get_AutoComplete","summary":"Auto Complete","tags":["Explore"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","title":"Search query","example":"Elon"}}]}},"/Search/":{"get":{"operationId":"get_Search","summary":"Search","tags":["Explore"],"parameters":[{"name":"q","in":"query","description":"You can use advanced search queries. E.g. dogecoin (from:elonmusk) Check out for more information: https://twitter.com/search-advanced","required":false,"schema":{"type":"string","title":"Search query","example":"Dogecoin"}},{"name":"type","in":"query","description":"Default: Top.","required":false,"schema":{"type":"string","enum":["Top","Latest","People","Media","Lists"],"title":"Search type","example":"Top"}},{"name":"count","in":"query","description":"Number of Tweet results","required":false,"schema":{"type":"integer","title":"Count","example":20}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}}]}},"/v1.1/Trends/":{"get":{"operationId":"get_v1_1_Trends","summary":"Trends","tags":["Explore"],"parameters":[{"name":"location_id","in":"query","description":"You must use the Locations endpoint to find IDs. Currently only countries are supported.","required":false,"schema":{"type":"string","title":"Location ID","example":"-7608764736147602991"}},{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}}]}},"/v1.1/Locations/":{"get":{"operationId":"get_v1_1_Locations","summary":"Locations","tags":["Explore"],"parameters":[{"name":"q","in":"query","description":"Leave blank to get countries","required":false,"schema":{"type":"string","title":"Search query"}}]}},"/v2/TweetDetail/":{"get":{"operationId":"get_v2_TweetDetail","summary":"Tweet Detail & Conversation","tags":["Tweet"],"parameters":[{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","required":false,"schema":{"type":"string","title":"Tweet ID","example":"1485953263040188416"}}]}},"/v2/Tweet/":{"get":{"operationId":"get_v2_Tweet","summary":"Tweet Detail / Alternative","tags":["Tweet"],"parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string","title":"Tweet ID","example":"1485953263040188416"}}]}},"/v2/Favoriters/":{"get":{"operationId":"get_v2_Favoriters","summary":"Tweet Favoriters","tags":["Tweet"],"parameters":[{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","required":false,"schema":{"type":"string","title":"Tweet ID","example":"1485953263040188416"}}]}},"/v2/Retweeters/":{"get":{"operationId":"get_v2_Retweeters","summary":"Tweet Retweeters","tags":["Tweet"],"parameters":[{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","required":false,"schema":{"type":"string","title":"Tweet ID","example":"1485953263040188416"}}]}},"/v1.1/TranslateTweet/":{"get":{"operationId":"get_v1_1_TranslateTweet","summary":"Translate Tweet","tags":["Tweet"],"parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string","title":"Tweet ID","example":"1485953263040188416"}},{"name":"language","in":"query","description":"Language code","required":false,"schema":{"type":"string","title":"Destination language","example":"es"}}]}},"/email-search/by-username":{"get":{"operationId":"get_email_search_by_username","summary":"Email Search (by username)","tags":["User"],"parameters":[{"name":"username","in":"query","required":false,"schema":{"type":"string","example":"RickRubin"}}]}},"/v1.1/Users/":{"get":{"operationId":"get_v1_1_Users","summary":"Get Users","tags":["User"],"parameters":[{"name":"ids","in":"query","description":"A comma separated list of User IDs. Up to 100 are allowed in a single request.","required":false,"schema":{"type":"string","title":"User IDs","example":"44196397"}},{"name":"usernames","in":"query","description":"A comma separated list of Usernames. Up to 100 are allowed in a single request.","required":false,"schema":{"type":"string","title":"User screen names","example":"BillGates,Google"}}]}},"/v2/UserByScreenName/":{"get":{"operationId":"get_v2_UserByScreenName","summary":"User By Screen Name","tags":["User"],"parameters":[{"name":"username","in":"query","required":false,"schema":{"type":"string","title":"Username","example":"elonmusk"}}]}},"/v2/UserByRestId/":{"get":{"operationId":"get_v2_UserByRestId","summary":"User By Rest ID","tags":["User"],"parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}}]}},"/v2/UsersByRestIds/":{"get":{"operationId":"get_v2_UsersByRestIds","summary":"Users By Rest IDs","tags":["User"],"parameters":[{"name":"ids","in":"query","description":"you can separate with commas","required":false,"schema":{"type":"string","title":"Users IDs","example":"44196397,155659213"}}]}},"/v2/UserTweets/":{"get":{"operationId":"get_v2_UserTweets","summary":"User Tweets","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"40"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}}]}},"/v2/UserTweetsAndReplies/":{"get":{"operationId":"get_v2_UserTweetsAndReplies","summary":"User Tweets & Replies","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"40"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}}]}},"/v2/UserMedia/":{"get":{"operationId":"get_v2_UserMedia","summary":"User Media","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}}]}},"/v2/Likes/":{"get":{"operationId":"get_v2_Likes","summary":"User Likes","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}}]}},"/v2/Followers/":{"get":{"operationId":"get_v2_Followers","summary":"User Followers","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}}]}},"/v1.1/Followers/":{"get":{"operationId":"get_v1_1_Followers","summary":"User Followers / Light","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results. Max: 200","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Exactly one of User ID or Username must be provided.","required":false,"schema":{"type":"string","title":"User ID"}},{"name":"username","in":"query","description":"Exactly one of User ID or Username must be provided.","required":false,"schema":{"type":"string","title":"Username","example":"elonmusk"}}]}},"/v1.1/FollowersIds/":{"get":{"operationId":"get_v1_1_FollowersIds","summary":"User Followers IDs","tags":["User"],"parameters":[{"name":"id","in":"query","description":"Exactly one of User ID or Username must be provided.","required":false,"schema":{"type":"string","title":"User ID"}},{"name":"username","in":"query","description":"Exactly one of User ID or Username must be provided.","required":false,"schema":{"type":"string","title":"Username","example":"elonmusk"}},{"name":"count","in":"query","description":"Number of results. Max: 5000","required":false,"schema":{"type":"string","title":"Count","example":"500"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","title":"Cursor token"}}]}},"/v2/VerifiedFollowers":{"get":{"operationId":"get_v2_VerifiedFollowers","summary":"User Verified Followers","tags":["User"],"parameters":[{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}},{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}}]}},"/v2/Following/":{"get":{"operationId":"get_v2_Following","summary":"User Following","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}}]}},"/v1.1/Following/":{"get":{"operationId":"get_v1_1_Following","summary":"User Following / Light","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results. Max: 200","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Exactly one of User ID or Username must be provided.","required":false,"schema":{"type":"string","title":"User ID"}},{"name":"username","in":"query","description":"Exactly one of User ID or Username must be provided.","required":false,"schema":{"type":"string","title":"Username","example":"elonmusk"}}]}},"/v1.1/FollowingIds/":{"get":{"operationId":"get_v1_1_FollowingIds","summary":"User Following IDs","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results. Max: 5000","required":false,"schema":{"type":"string","title":"Count","example":"500"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Exactly one of User ID or Username must be provided.","required":false,"schema":{"type":"string","title":"User ID"}},{"name":"username","in":"query","description":"Exactly one of User ID or Username must be provided.","required":false,"schema":{"type":"string","title":"Username","example":"elonmusk"}}]}},"/v2/Subscriptions":{"get":{"operationId":"get_v2_Subscriptions","summary":"User Subscriptions","tags":["User"],"parameters":[{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}},{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}}]}},"/v2/UserAffiliates/":{"get":{"operationId":"get_v2_UserAffiliates","summary":"User Affiliates","tags":["User"],"parameters":[{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}},{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"34743251"}}]}},"/v2/UserHighlights":{"get":{"operationId":"get_v2_UserHighlights","summary":"User Highlights","tags":["User"],"parameters":[{"name":"id","in":"query","description":"Use the User By Screen Name endpoint to find the ID from a username.","required":false,"schema":{"type":"string","title":"User ID","example":"44196397"}},{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}}]}},"/v1.1/TranslateProfile/":{"get":{"operationId":"get_v1_1_TranslateProfile","summary":"Translate Profile","tags":["User"],"parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string","title":"User ID","example":"50393960"}},{"name":"language","in":"query","description":"Language code","required":false,"schema":{"type":"string","title":"Destination language","example":"es"}}]}},"/ShortUrl":{"get":{"operationId":"get_ShortUrl","summary":"Short URL / t.co","description":"Twitter URL shortening service","tags":["Misc"],"parameters":[{"name":"url","in":"query","description":"The URL you want shortened","required":false,"schema":{"type":"string","title":"Long URL","example":"https://jojapi.com/api/twitter"}}]}},"/v1.1/Hashflags":{"get":{"operationId":"get_v1_1_Hashflags","summary":"Hashflags","tags":["Misc"]}},"/v2/ListTimeline":{"get":{"operationId":"get_v2_ListTimeline","summary":"List Timeline","tags":["List"],"parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"string","title":"List ID","example":"875371355570487296"}},{"name":"count","in":"query","description":"Number of results","required":false,"schema":{"type":"string","title":"Count","example":"20"}},{"name":"cursor","in":"query","description":"Cursor for other results","required":false,"schema":{"type":"string","title":"Cursor token"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}