json-formatter-js

{ "swagger": "2.0", "info": { "version": "1.1", "title": "Twitter REST API This is interesting in so many cases" }, "host": "api.twitter.com", "basePath": "/1.1", "schemes": ["http", "https"], "consumes": ["application/json"], "produces": ["application/json"], "securityDefinitions": { "oauth": { "type": "oauth2", "flow": "implicit", "authorizationUrl": "https://twitter.com/oauth/authorize/?client_id=CLIENT-ID&redirect_uri=REDIRECT-URI&response_type=token", "scopes": { "basic": "to read any and all data related to twitter this is interesting op\n" } } }, "security": [ { "oauth": ["basic"] } ], "paths": { "/statuses/mentions_timeline": { "get": { "description": "Returns the 20 most recent mentions for the authenticating kkkkkkk user", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "count", "in": "query", "description": "Specifies the number of tweets to try and retrieve", "required": false, "type": "string" }, { "name": "since_id", "in": "query", "description": "Returns result with an ID greater than the specified ID", "required": false, "type": "string" }, { "name": "max_id", "in": "query", "description": "Returns results with an ID less than or equal to the specified ID", "required": false, "type": "string" }, { "name": "trim_user", "in": "query", "description": "When set to either true, t or 1, each tweet returned in a timeline will include a user object", "required": false, "type": "string" }, { "name": "contributor_details", "in": "query", "description": "This parameter enhances the contributors element of the status response", "required": false, "type": "string" }, { "name": "include_entities", "in": "query", "description": "The entities node will be disincluded when set to false", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "type": "array", "items": { "$ref": "#/definitions/Tweets" } } } } } }, "/statuses/user_timeline": { "get": { "description": "Returns a collection of the most recent Tweets posted by the User", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "count", "in": "query", "description": "Specifies the number of tweets to try and rppetrieve", "required": false, "type": "string" }, { "name": "since_id", "in": "query", "description": "Returns result with an ID greater than the specified ID", "required": false, "type": "string" }, { "name": "max_id", "in": "query", "description": "Returns results with an ID less than or equal to the specified ID", "required": false, "type": "string" }, { "name": "trim_user", "in": "query", "description": "When set to either true, t or 1, each tweet returned in a timeline will include a user object", "required": false, "type": "string" }, { "name": "exclude_replies", "in": "query", "description": "This paramters will prevent from appearing in the returned timeline", "required": false, "type": "boolean" }, { "name": "contributor_details", "in": "query", "description": "This paramters enhances the contributors element of the status response to include the screen_name of the contributor", "required": false, "type": "boolean" }, { "name": "include_rts", "in": "query", "description": "When set to false, the timeline will strip any native retweet", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Success", "schema": { "type": "array", "items": { "$ref": "#/definitions/Tweets" } } } } } }, "/statuses/home_timeline": { "get": { "description": "Returns a collection of the most recent Tweets", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "since_id", "in": "query", "description": "Returns result with an ID greater than the specified ID", "required": false, "type": "string" }, { "name": "max_id", "in": "query", "description": "Returns results with an ID less than or equal to the specified ID", "required": false, "type": "string" }, { "name": "trim_user", "in": "query", "description": "When set to either true, t or 1, each tweet returned in a timeline will include a user object", "required": false, "type": "string" }, { "name": "exclude_replies", "in": "query", "description": "This paramters will prevent from appearing in the returned timeline", "required": false, "type": "boolean" }, { "name": "contributor_details", "in": "query", "description": "This paramters enhances the contributors element of the status response to include the screen_name of the contributor", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Success", "schema": { "type": "array", "items": { "$ref": "#/definitions/Tweets" } } } } } }, "/statuses/retweets/{id}": { "post": { "description": "Retweens a tweet", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "id", "in": "path", "description": "The numerical ID of the desired status", "required": true, "type": "string" }, { "name": "trim_user", "in": "query", "description": "When set to either true, t or 1, each tweet returned in a timeline will include a user object", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Tweets" } } } } }, "/statuses/show/{id}": { "get": { "description": "Retruns a single Tweet", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "id", "in": "path", "description": "The numerical ID of the desired status", "required": true, "type": "string" }, { "name": "trim_user", "in": "query", "description": "When set to either true, t or 1, each tweet returned in a timeline will include a user object", "required": false, "type": "string" }, { "name": "include_my_retweet", "in": "query", "description": "When set to either true, t or 1, any Tweets returned that have been retweeted by the authenticating", "required": true, "type": "string" }, { "name": "include_entities", "type": "string", "in": "query", "description": "The entities node will be disincluded when set to false", "required": false } ], "responses": { "200": { "description": "Success if that matters wd sw", "schema": { "$ref": "#/definitions/Tweets" } } } } }, "/statuses/destroy/{id}": { "post": { "description": "Destroys the status specified by the required ID parameter", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "id", "in": "path", "description": "The numerical ID of the desired status", "required": true, "type": "string" }, { "name": "trim_user", "in": "query", "description": "When set to either true, t or 1, each tweet returned in a timeline will include a user object", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Tweets" } } } } }, "/statuses/update": { "post": { "description": "Updates the authenticating user's status", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "status", "in": "query", "description": "The text of your status update", "required": true, "type": "string" }, { "name": "in_reply_to_status_id", "in": "query", "description": "The ID of an existing status", "required": false, "type": "string" }, { "name": "lat", "in": "query", "description": "The latitude of the location", "required": false, "type": "string" }, { "name": "long", "in": "query", "description": "The longitude of the location", "required": false, "type": "string" }, { "name": "place_id", "in": "query", "description": "A place in the world", "required": false, "type": "string" }, { "name": "display_coordinates", "in": "query", "description": "Whether or not to put a pin on the exact coordinates a tweet", "required": false, "type": "string" }, { "name": "trim_user", "in": "query", "description": "When set to either true, t or 1, each tweet returned in a timeline will include a user object", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Tweets" } }, "403": { "description": "Error" } } } }, "/statuses/oembed": { "get": { "description": "Returns information allowing the creation of an embedded representation", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "id", "in": "query", "description": "The tweet/status id to return embed code for", "required": true, "type": "string" }, { "name": "url", "in": "query", "description": "The encoded URL of the Tweet status to be embedded", "required": true, "type": "string" }, { "name": "maxwidth", "in": "query", "description": "The maximum width in pixels that the embed should be rendered at", "required": false, "type": "string" }, { "name": "hide_media", "in": "query", "description": "Specifies whether the embedded tweet should automatically show the original message in the case that the embedded Tweet is a reply", "required": false, "type": "string" }, { "name": "hide_thread", "in": "query", "description": "Specifies whether the embedded Tweet html should include a 'script' element pointing to widgets.js", "required": false, "type": "string" }, { "name": "align", "in": "query", "description": "Specifies whether the embedded Tweet should be left aligned", "required": false, "type": "string" }, { "name": "related", "in": "query", "description": "A value for the TWT related parameters", "required": false, "type": "string" }, { "name": "lang", "in": "query", "description": "Languages code for the rendered embed", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Tweets" } } } } }, "/lists/list": { "get": { "description": "Return all lists the authenticating or specified user subscribes to, including their own.", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "screen_name", "in": "query", "description": "The screen name of the user for whom to return results for Hey jeremey ijikjkhj,kb kukj", "required": true, "type": "string" }, { "name": "user_id", "in": "query", "description": "The ID of the user for whom to return results for", "required": true, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "type": "array", "items": { "$ref": "#/definitions/Lists" } } } } } }, "/lists/statuses": { "get": { "description": "Returns a timeline of tweets authored by memebers of the specified list", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list by its slug instead of its numerical id", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "since_id", "in": "query", "description": "Returns results with an ID greater than the sepcified ID", "required": false, "type": "string" }, { "name": "max_id", "in": "query", "description": "Returns results with an ID less than or equal to the specified ID", "required": false, "type": "string" }, { "name": "count", "in": "query", "description": "Specifies the number of results to retrieve per page", "required": false, "type": "string" }, { "name": "include_entities", "in": "query", "description": "Entities are ON by default", "required": false, "type": "string" }, { "name": "include_rts", "in": "query", "description": "When set to either true, t or 1, the list timeline will contain native retweets in addition to the standard stream of tweets", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "type": "array", "items": { "$ref": "#/definitions/Tweets" } } } } } }, "/lists/members/destroy": { "get": { "description": "Returns the list of memebers destroy", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list by its slug instrad of its numerical id", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "user_id", "in": "query", "description": "The id of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "screen_name", "in": "query", "description": "The screen name of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The is of the user who wons the list being requested by a slug", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success" } } } }, "/lists/memberships": { "get": { "description": "Returns the lists of the specified user has been added to", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "user_id", "in": "query", "description": "The id of the user for whom to return results for", "required": false, "type": "string" }, { "name": "screen_name", "in": "query", "description": "The screen name of the user for whom to return results for", "required": false, "type": "string" }, { "name": "cursor", "in": "query", "description": "Breaks the results into pages", "required": false, "type": "string" }, { "name": "filter_to_owned_lists", "in": "query", "description": "When set to true, t or 1, will return just lists the authenticating user owns", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Cursor_lists" } } } } }, "/lists/subscribers": { "get": { "description": "Returns the subscribers of the specified list", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list by its slug insted of its numerical id", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "the screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "cursor", "in": "query", "description": "Breaks the results into pages", "required": false, "type": "string" }, { "name": "include_entities", "in": "query", "description": "Wehn set to either true, t or 1", "required": false, "type": "string" }, { "name": "skip_status", "in": "query", "description": "When set to either true, t or 1", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Cursor_lists" } } } } }, "/lists/subscribers/create": { "post": { "description": "Subscribes the authenticated user to the specified list", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "the screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Lists" } } } } }, "/lists/subscribers/show": { "get": { "description": "Check if the specified user is a subscriber of the specified list", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "user_id", "in": "query", "description": "The id of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "screen_name", "in": "query", "description": "The screen name of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The is of the user who wons the list being requested by a slug", "required": false, "type": "string" }, { "name": "include_entities", "in": "query", "description": "Wehn set to either true, t or 1", "required": false, "type": "string" }, { "name": "skip_status", "in": "query", "description": "When set to either true, t or 1", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Users" } } } } }, "/lists/subscribers/destroy": { "get": { "description": "Returns list of subscribers destroy", "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "the screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success" } } } }, "/lists/members/create_all": { "get": { "description": "Returns lists of members create_all", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "the screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "user_id", "in": "query", "description": "The id of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "screen_name", "in": "query", "description": "The screen name of the user for whom to remove from the list", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success" } } } }, "/list/members/show": { "get": { "description": "Check if the specified user is a member of the specified list", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "user_id", "in": "query", "description": "The id of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "screen_name", "in": "query", "description": "The screen name of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "include_entities", "in": "query", "description": "Wehn set to either true, t or 1", "required": false, "type": "string" }, { "name": "skip_status", "in": "query", "description": "When set to either true, t or 1", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Users" } } } } }, "/list/members": { "get": { "description": "Returns the members of the specified list", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "include_entities", "in": "query", "description": "Wehn set to either true, t or 1", "required": false, "type": "string" }, { "name": "skip_status", "in": "query", "description": "When set to either true, t or 1", "required": false, "type": "string" }, { "name": "cursor", "in": "query", "description": "Breaks the results into pages", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Users" } } } } }, "/list/members/create": { "post": { "description": "Returns list of members create", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "screen_name", "in": "query", "description": "The screen name of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success" } } } }, "/lists/destroy": { "post": { "description": "Returns list of destroy", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Lists" } } } } }, "/lists/update": { "post": { "description": "Returns lists of updates", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "name", "in": "query", "description": "The name for the list", "required": false, "type": "string" }, { "name": "mode", "in": "query", "description": "Whether your list is public or private", "required": false, "type": "string" }, { "name": "description", "in": "query", "description": "The description to give the list", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success" } } } }, "/lists/create": { "post": { "description": "Returns list of create", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "name", "in": "query", "description": "The name for the list", "required": false, "type": "string" }, { "name": "mode", "in": "query", "description": "Whether your list is public or private", "required": false, "type": "string" }, { "name": "description", "in": "query", "description": "The description to give the list", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Lists" } } } } }, "/lists/show": { "get": { "description": "Returns list of show", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Lists" } } } } }, "/lists/subscriptions": { "get": { "description": "Returns list of subscriptions", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "screen_name", "in": "query", "description": "The screen name of the user", "required": false, "type": "string" }, { "name": "user_id", "in": "query", "description": "The id of the user for whom to return results for", "required": false, "type": "string" }, { "name": "count", "in": "query", "description": "The amount of results to return per page", "required": false, "type": "string" }, { "name": "cursor", "in": "query", "description": "Breaks the results into pages", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Cursor_lists" } } } } }, "/list/members/destroy_all": { "get": { "description": "Returns lists of destroy all", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "list_id", "in": "query", "description": "The numerical id of the list", "required": true, "type": "string" }, { "name": "slug", "in": "query", "description": "You can identify a list being requested by a slug", "required": true, "type": "string" }, { "name": "user_id", "in": "query", "description": "The id of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "screen_name", "in": "query", "description": "The screen name of the user for whom to remove from the list", "required": false, "type": "string" }, { "name": "owner_screen_name", "in": "query", "description": "The screen name of the user who owns the list being requested by a slug", "required": false, "type": "string" }, { "name": "owner_id", "in": "query", "description": "The user ID of the user who owns the list being requested by a slug", "required": false, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Cursor_lists" } } } } }, "/direct_messages/sent": { "get": { "description": "return 20 most recent direct messages sent", "parameters": [ { "name": "since_id", "in": "query", "required": false, "type": "string" }, { "name": "max_id", "in": "query", "required": false, "type": "string" }, { "name": "count", "in": "query", "required": false, "type": "string" }, { "name": "page", "in": "query", "required": false, "type": "string" }, { "name": "include_entities", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/Messages" } } } } } }, "/direct_messages/show": { "get": { "description": "returns a single direct message specified by an id", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "id", "in": "query", "description": "ID of direct message", "type": "string", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/Messages" } } } } } }, "/search/tweets": { "get": { "description": "returns collection of relevant Tweets matching query", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "q", "in": "query", "description": "URL-encoded search query of 500 characters max", "type": "string", "required": true }, { "name": "geocode", "in": "query", "description": "returns tweets by users located within given radius", "type": "string", "required": false }, { "name": "lang", "in": "query", "description": "restricts tweets to a given language", "type": "string", "required": false }, { "name": "locale", "in": "query", "description": "language of query you are sending", "type": "string", "required": false }, { "name": "result_type", "in": "query", "description": "specifies type of search results you prefer", "type": "string", "required": false }, { "name": "count", "in": "query", "description": "number of tweets to return", "type": "string" }, { "name": "until", "in": "query", "description": "returns tweets created before given date", "type": "string" }, { "name": "since_id", "in": "query", "description": "return results with ID greater than specified", "type": "string" }, { "name": "max_id", "in": "query", "description": "returns results with an ID less than/equal to specified ID", "type": "string" }, { "name": "include_entities", "in": "query", "description": "whether or not to include entities", "type": "string" }, { "name": "callback", "in": "query", "description": "response will use the callback with given name", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "$ref": "#/definitions/Tweets" } } } } } }, "/saved_searches/list": { "get": { "description": "Returns the authenticated user's saved search queries", "security": [ { "oauth": ["basic"] } ], "responses": { "200": { "description": "Success", "schema": { "type": "array", "items": { "$ref": "#/definitions/Query" } } } } } }, "/saved_searches/show/{id}": { "get": { "description": "Retrieve the information for the saved search represented by the given id", "security": [ { "oauth": ["basic"] } ], "parameters": [ { "name": "id", "in": "path", "description": "The id of the saved search", "required": true, "type": "string" } ], "responses": { "200": { "description": "Success", "schema": { "$ref": "#/definitions/Query" } } } } }, "/saved_searches/create": { "post": { "description": "Create a new saved search for the authenticated user", "security": [ { "oauth": ["