{"openapi":"3.0.0","info":{"description":"Twitter API v2 available endpoints","version":"2.30","title":"Twitter API v2","termsOfService":"https://developer.twitter.com/en/developer-terms/agreement-and-policy.html","contact":{"name":"Twitter Developers","url":"https://developer.twitter.com/"},"license":{"name":"Twitter Developer Agreement and Policy","url":"https://developer.twitter.com/en/developer-terms/agreement-and-policy.html"}},"servers":[{"description":"Twitter API","url":"https://api.twitter.com"}],"tags":[{"name":"Compliance","description":"Endpoints related to keeping Twitter data in your systems compliant","externalDocs":{"description":"Find out more","url":"https://developer.twitter.com/en/docs/twitter-api/compliance/batch-tweet/introduction"}},{"name":"General","description":"Miscellaneous endpoints for general API functionality","externalDocs":{"description":"Find out more","url":"https://developer.twitter.com/en/docs/twitter-api"}},{"name":"Lists","description":"Endpoints related to retrieving, managing Lists","externalDocs":{"description":"Find out more","url":"https://developer.twitter.com/en/docs/twitter-api/lists"}},{"name":"Spaces","description":"Endpoints related to retrieving, managing Spaces","externalDocs":{"description":"Find out more","url":"https://developer.twitter.com/en/docs/twitter-api/spaces"}},{"name":"Tweets","description":"Endpoints related to retrieving, searching, and modifying Tweets","externalDocs":{"description":"Find out more","url":"https://developer.twitter.com/en/docs/twitter-api/tweets/lookup"}},{"name":"Users","description":"Endpoints related to retrieving, managing relationships of Users","externalDocs":{"description":"Find out more","url":"https://developer.twitter.com/en/docs/twitter-api/users/lookup"}}],"paths":{"/2/users":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Users"],"summary":"User lookup by IDs","description":"This endpoint returns information about users. Specify users by their ID.","operationId":"findUsersById","parameters":[{"name":"ids","in":"query","description":"Required. A list of User IDs, comma-separated. You can specify up to 100 IDs.","required":true,"example":"2244994945,6253282,12","schema":{"type":"array","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"minItems":1,"maxItems":100},"style":"form","explode":false},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [User](#User) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["pinned_tweet_id"]},"minItems":1,"uniqueItems":true,"example":["pinned_tweet_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Users"],"summary":"User lookup by ID","description":"This endpoint returns information about a user. Specify user by ID.","operationId":"findUserById","parameters":[{"name":"id","in":"path","description":"Required. A User ID.","required":true,"example":"2244994945","schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [User](#User) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["pinned_tweet_id"]},"minItems":1,"uniqueItems":true,"example":["pinned_tweet_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/by":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Users"],"summary":"User lookup by usernames","description":"This endpoint returns information about users. Specify users by their username.","operationId":"findUsersByUsername","parameters":[{"name":"usernames","in":"query","description":"Required . A list of usernames, comma-separated. You can specify up to 100 usernames.","required":true,"example":"TwitterDev,TwitterAPI,jack","schema":{"type":"array","items":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"minItems":1,"maxItems":100},"style":"form","explode":false},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [User](#User) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["pinned_tweet_id"]},"minItems":1,"uniqueItems":true,"example":["pinned_tweet_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/by/username/{username}":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Users"],"summary":"User lookup by username","description":"This endpoint returns information about a user. Specify user by username.","operationId":"findUserByUsername","parameters":[{"name":"username","in":"path","required":true,"description":"Required. A username.","example":"TwitterDev","schema":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [User](#User) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["pinned_tweet_id"]},"minItems":1,"uniqueItems":true,"example":["pinned_tweet_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/blocking":{"post":{"tags":["Users"],"summary":"Block User by User ID","description":"Causes the user (in the path) to block the target user. The user (in the path) must match the user context authorizing the request","operationId":"usersIdBlock","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user that is requesting to block the target user","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["target_user_id"],"properties":{"target_user_id":{"type":"string","pattern":"^[0-9]{1,19}$"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"blocking":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"get":{"tags":["Users"],"summary":"Returns user objects that are blocked by provided user ID","description":"Returns a list of users that are blocked by the provided user ID","operationId":"usersIdBlocking","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user for whom to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":1000}},{"name":"pagination_token","in":"query","description":"This value is populated by passing the 'next_token' or 'previous_token' returned in a request to paginate through results.","required":false,"schema":{"type":"string","minLength":16,"maxLength":16}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{source_user_id}/blocking/{target_user_id}":{"delete":{"tags":["Users"],"summary":"Unblock User by User ID","description":"Causes the source user to unblock the target user. The source user must match the user context authorizing the request","operationId":"usersIdUnblock","security":[{"UserToken":[]}],"parameters":[{"name":"source_user_id","in":"path","description":"The ID of the user that is requesting to unblock the target user","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"target_user_id","in":"path","description":"The ID of the user that the source user is requesting to unblock","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"blocking":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{source_user_id}/muting/{target_user_id}":{"delete":{"tags":["Users"],"summary":"Unmute User by User ID","description":"Causes the source user to unmute the target user. The source user must match the user context authorizing the request","operationId":"usersIdUnmute","security":[{"UserToken":[]}],"parameters":[{"name":"source_user_id","in":"path","description":"The ID of the user that is requesting to unmute the target user","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"target_user_id","in":"path","description":"The ID of the user that the source user is requesting to unmute","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"muting":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/muting":{"post":{"tags":["Users"],"summary":"Mute User by User ID","description":"Causes the user (in the path) to mute the target user. The user (in the path) must match the user context authorizing the request","operationId":"usersIdMute","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user that is requesting to mute the target user","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["target_user_id"],"properties":{"target_user_id":{"type":"string","pattern":"^[0-9]{1,19}$"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"muting":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"get":{"tags":["Users"],"summary":"Returns user objects that are muted by the provided user ID","description":"Returns a list of users that are muted by the provided user ID","operationId":"usersIdMuting","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user for whom to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":1000,"default":100}},{"name":"pagination_token","in":"query","description":"This parameter is used to get the next 'page' of results.","required":false,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/followers":{"get":{"tags":["Users"],"summary":"Returns user objects that follow the provided user ID","description":"Returns a list of users that follow the provided user ID","operationId":"usersIdFollowers","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user for whom to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":1000}},{"name":"pagination_token","in":"query","description":"This value is populated by passing the 'next_token' or 'previous_token' returned in a request to paginate through results.","required":false,"schema":{"type":"string","minLength":16,"maxLength":16}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/following":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Users"],"summary":"Following by User ID","description":"Returns a list of users that are being followed by the provided user ID","operationId":"usersIdFollowing","parameters":[{"name":"id","in":"path","description":"The ID of the user for whom to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":1000}},{"name":"pagination_token","in":"query","description":"This value is populated by passing the 'next_token' or 'previous_token' returned in a request to paginate through results.","required":false,"schema":{"type":"string","minLength":16,"maxLength":16}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"post":{"tags":["Users"],"summary":"Follow User","description":"Causes the user(in the path) to follow, or “request to follow” for protected users, the target user. The user(in the path) must match the user context authorizing the request","operationId":"usersIdFollow","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user that is requesting to follow the target user","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["target_user_id"],"properties":{"target_user_id":{"type":"string","pattern":"^[0-9]{1,19}$"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"following":{"type":"boolean"},"pending_follow":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{source_user_id}/following/{target_user_id}":{"delete":{"tags":["Users"],"summary":"Unfollow User","description":"Causes the source user to unfollow the target user. The source user must match the user context authorizing the request","operationId":"usersIdUnfollow","security":[{"UserToken":[]}],"parameters":[{"name":"source_user_id","in":"path","description":"The ID of the user that is requesting to unfollow the target user","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"target_user_id","in":"path","description":"The ID of the user that the source user is requesting to unfollow","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"following":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/followed_lists":{"get":{"tags":["Lists"],"summary":"Get User's Followed Lists","description":"Returns a user's followed Lists.","operationId":"userFollowedLists","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user for whom to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","description":"This parameter is used to get a specified 'page' of results.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"list.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of List fields to display.","schema":{"description":"The fields available for a List object.","type":"array","items":{"type":"string","enum":["created_at","description","follower_count","id","member_count","name","owner_id","private"]},"minItems":1,"uniqueItems":true,"example":["created_at","description","follower_count","member_count","name","private"]}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [List](#List) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["owner_id"]},"minItems":1,"uniqueItems":true,"example":["owner_id"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"minItems":0},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^-?[0-9]{1,19}$"},"next_token":{"description":"The next token","type":"string","pattern":"^-?[0-9]{1,19}$"},"result_count":{"description":"The number of list results returned in this response","type":"integer"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"post":{"tags":["Lists"],"summary":"Follow a List","description":"Causes a user to follow a List.","operationId":"listUserFollow","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the authenticated source user that will follow the List","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"list_id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"following":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/followed_lists/{list_id}":{"delete":{"tags":["Lists"],"summary":"Unfollow a List","description":"Causes a user to unfollow a List.","operationId":"listUserUnfollow","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the authenticated source user that will unfollow the List","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"list_id","in":"path","description":"The ID of the List to unfollow","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"following":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/list_memberships":{"get":{"tags":["Lists"],"summary":"Get a User's List Memberships","description":"Get a User's List Memberships.","operationId":"getUserListMemberships","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user for whom to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","description":"This parameter is used to get a specified 'page' of results.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"list.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of List fields to display.","schema":{"description":"The fields available for a List object.","type":"array","items":{"type":"string","enum":["created_at","description","follower_count","id","member_count","name","owner_id","private"]},"minItems":1,"uniqueItems":true,"example":["created_at","description","follower_count","member_count","name","private"]}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [List](#List) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["owner_id"]},"minItems":1,"uniqueItems":true,"example":["owner_id"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"minItems":0},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^-?[0-9]{1,19}$"},"next_token":{"description":"The next token","type":"string","pattern":"^-?[0-9]{1,19}$"},"result_count":{"description":"The number of list results returned in this response","type":"integer"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/owned_lists":{"get":{"tags":["Lists"],"summary":"Get a User's Owned Lists","description":"Get a User's Owned Lists.","operationId":"listUserOwnedLists","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user for whom to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","description":"This parameter is used to get a specified 'page' of results.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"list.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of List fields to display.","schema":{"description":"The fields available for a List object.","type":"array","items":{"type":"string","enum":["created_at","description","follower_count","id","member_count","name","owner_id","private"]},"minItems":1,"uniqueItems":true,"example":["created_at","description","follower_count","member_count","name","private"]}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [List](#List) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["owner_id"]},"minItems":1,"uniqueItems":true,"example":["owner_id"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"minItems":0},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^-?[0-9]{1,19}$"},"next_token":{"description":"The next token","type":"string","pattern":"^-?[0-9]{1,19}$"},"result_count":{"description":"The number of list results returned in this response","type":"integer"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/pinned_lists":{"get":{"tags":["Lists"],"summary":"Get a User's Pinned Lists","description":"Get a User's Pinned Lists.","operationId":"listUserPinnedLists","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user for whom to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"list.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of List fields to display.","schema":{"description":"The fields available for a List object.","type":"array","items":{"type":"string","enum":["created_at","description","follower_count","id","member_count","name","owner_id","private"]},"minItems":1,"uniqueItems":true,"example":["created_at","description","follower_count","member_count","name","private"]}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [List](#List) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["owner_id"]},"minItems":1,"uniqueItems":true,"example":["owner_id"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"minItems":0},"meta":{"type":"object","properties":{"result_count":{"description":"The number of list results returned in this response","type":"integer"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"post":{"tags":["Lists"],"summary":"Pin a List","description":"Causes a user to pin a List.","operationId":"listUserPin","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the authenticated source user that will pin the List","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"list_id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"pinned":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/pinned_lists/{list_id}":{"delete":{"tags":["Lists"],"summary":"Unpin a List","description":"Causes a user to remove a pinned List.","operationId":"listUserUnpin","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the authenticated source user that will remove the pinned List","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"list_id","in":"path","description":"The ID of the List to unpin","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"pinned":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Tweets"],"summary":"Tweet lookup by Tweet IDs","description":"Returns a variety of information about the Tweet specified by the requested ID.","operationId":"findTweetsById","parameters":[{"name":"ids","in":"query","description":"A comma separated list of Tweet IDs. Up to 100 are allowed in a single request.","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"minItems":1,"maxItems":100}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"post":{"security":[{"UserToken":[]}],"tags":["Tweets"],"summary":"Creation of a Tweet","description":"Causes the user to create a tweet under the authorized account.","operationId":"createTweet","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"direct_message_deep_link":{"type":"string","description":"Link to take the conversation from the public timeline to a private Direct Message."},"quote_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"for_super_followers_only":{"type":"boolean","description":"Exclusive Tweet for super followers."},"reply":{"type":"object","description":"Tweet information of the Tweet being replied to.","properties":{"in_reply_to_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"exclude_reply_user_ids":{"type":"array","description":"A list of User Ids to be excluded from the reply Tweet.","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}},"media":{"type":"object","description":"Media information being attached to created Tweet. This is mutually exclusive from Quote Tweet Id and Poll.","properties":{"media_ids":{"type":"array","description":"A list of Media Ids to be attached to a created Tweet.","items":{"type":"string","description":"The unique identifier of this Media.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}},"tagged_user_ids":{"type":"array","description":"A list of User Ids to be tagged in the media for created Tweet.","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}},"poll":{"type":"object","description":"Poll options for a Tweet with a poll. This is mutually exclusive from Media and Quote Tweet Id.","properties":{"options":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"duration_minutes":{"type":"integer","format":"int32","minimum":5,"maximum":10080,"description":"Duration of the poll in minutes."}}},"reply_settings":{"type":"string","enum":["following","mentionedUsers"],"description":"Settings to indicate who can reply to the Tweet."},"geo":{"type":"object","description":"Place ID being attached to the Tweet for geo location.","properties":{"place_id":{"type":"string"}}}}}}}},"parameters":[],"responses":{"201":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/{id}":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Tweets"],"summary":"Tweet lookup by Tweet ID","description":"Returns a variety of information about the Tweet specified by the requested ID.","operationId":"findTweetById","parameters":[{"name":"id","in":"path","description":"A single Tweet ID.","required":true,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"delete":{"security":[{"UserToken":[]}],"tags":["Tweets"],"summary":"Tweet delete by Tweet ID","description":"Delete specified Tweet (in the path) by ID.","operationId":"deleteTweetById","parameters":[{"name":"id","in":"path","description":"The ID of the Tweet to be deleted.","required":true,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["deleted"],"properties":{"deleted":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/{id}/hidden":{"put":{"tags":["Tweets"],"summary":"Hide replies","description":"Hides or unhides a reply to an owned conversation.","operationId":"hideReplyById","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the reply that you want to hide or unhide.","required":true,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"hidden":{"type":"boolean"}}}}}},"responses":{"200":{"description":"A successful response. The reply has been hidden or unhidden.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"hidden":{"type":"boolean"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/search/recent":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Tweets"],"summary":"Recent search","description":"Returns Tweets from the last 7 days that match a search query.","operationId":"tweetsRecentSearch","parameters":[{"in":"query","name":"query","description":"One query/rule/filter for matching Tweets. Up to 512 characters.","required":true,"schema":{"type":"string","minLength":1,"maxLength":512,"example":"(from:TwitterDev OR from:TwitterAPI) has:media -is:retweet"}},{"in":"query","name":"start_time","description":"YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp (from most recent 7 days) from which the Tweets will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).","required":false,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"end_time","description":"YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Tweets will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).","required":false,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"since_id","description":"Returns results with a Tweet ID greater than (that is, more recent than) the specified ID.","required":false,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"in":"query","name":"until_id","description":"Returns results with a Tweet ID less than (that is, older than) the specified ID.","required":false,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"in":"query","name":"max_results","description":"The maximum number of search results to be returned by a request.","required":false,"schema":{"type":"integer","format":"int32","minimum":10,"maximum":100,"default":10}},{"in":"query","name":"next_token","description":"This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.","required":false,"schema":{"type":"string","minLength":1}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}}],"responses":{"200":{"description":"Tweets recent search response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"newest_id":{"type":"string","pattern":"^[0-9]{1,19}$","description":"Most recent Tweet Id returned by search query"},"oldest_id":{"type":"string","pattern":"^[0-9]{1,19}$","description":"Oldest Tweet Id returned by search query"},"next_token":{"description":"This value is used to get the next 'page' of results by providing it to the next_token parameter.","type":"string"},"result_count":{"description":"Number of search query results","type":"integer","format":"int32"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/search/all":{"get":{"security":[{"BearerToken":[]}],"tags":["Tweets"],"summary":"Full-archive search","description":"Returns Tweets that match a search query.","operationId":"tweetsFullarchiveSearch","parameters":[{"in":"query","name":"query","description":"One query/rule/filter for matching Tweets. Up to 1024 characters.","required":true,"schema":{"type":"string","minLength":1,"maxLength":1024,"example":"(from:TwitterDev OR from:TwitterAPI) has:media -is:retweet"}},{"in":"query","name":"start_time","description":"YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp from which the Tweets will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).","required":false,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"end_time","description":"YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Tweets will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).","required":false,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"since_id","description":"Returns results with a Tweet ID greater than (that is, more recent than) the specified ID.","required":false,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"in":"query","name":"until_id","description":"Returns results with a Tweet ID less than (that is, older than) the specified ID.","required":false,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"in":"query","name":"max_results","description":"The maximum number of search results to be returned by a request.","required":false,"schema":{"type":"integer","format":"int32","minimum":10,"maximum":500,"default":10}},{"in":"query","name":"next_token","description":"This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.","required":false,"schema":{"type":"string","minLength":1}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}}],"responses":{"200":{"description":"Tweets full archive search response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"newest_id":{"type":"string","pattern":"^[0-9]{1,19}$","description":"Most recent Tweet Id returned by search query"},"oldest_id":{"type":"string","pattern":"^[0-9]{1,19}$","description":"Oldest Tweet Id returned by search query"},"next_token":{"description":"This value is used to get the next 'page' of results by providing it to the next_token parameter.","type":"string"},"result_count":{"description":"Number of search query results","type":"integer","format":"int32"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/search/stream":{"get":{"security":[{"BearerToken":[]}],"tags":["Tweets"],"x-twitter-streaming":true,"summary":"Filtered stream","description":"Streams Tweets matching the stream's active rule set.","operationId":"searchStream","parameters":[{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}},{"name":"backfill_minutes","in":"query","description":"The number of minutes of backfill requested","required":false,"schema":{"type":"integer","format":"int32","minimum":0,"maximum":5}}],"responses":{"200":{"description":"The request was successful. Successful responses will return a stream of individual JSON Tweet payloads.","content":{"application/json":{"schema":{"type":"object","description":"A tweet or error that can be returned by the streaming tweet API","oneOf":[{"type":"object","description":"The values returned with a successful streamed tweet. Includes the user provided rules that the tweet matched.","required":["data","matching_rules"],"properties":{"data":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"matching_rules":{"type":"array","description":"The list of rules which matched the tweet","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"},"tag":{"type":"string","description":"The user-supplied tag assigned to the rule which matched"}}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}}}},{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}]}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/search/stream/rules":{"get":{"security":[{"BearerToken":[]}],"tags":["Tweets"],"summary":"Rules lookup","description":"Returns rules from a user's active rule set. Users can fetch all of their rules or a subset, specified by the provided rule ids.","operationId":"getRules","parameters":[{"name":"ids","in":"query","description":"A comma-separated list of Rule IDs.","required":false,"schema":{"type":"array","items":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"}}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":1000,"default":1000}},{"name":"pagination_token","in":"query","description":"This value is populated by passing the 'next_token' returned in a request to paginate through results.","required":false,"schema":{"type":"string","minLength":16,"maxLength":16}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","description":"A user-provided stream filtering rule.","required":["value"],"properties":{"value":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"tag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"},"id":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"}}}},"meta":{"type":"object","required":["sent"],"properties":{"sent":{"type":"string"},"summary":{"type":"object","oneOf":[{"type":"object","description":"A summary of the results of the addition of user-specified stream filtering rules.","required":["created","not_created","valid","invalid"],"properties":{"created":{"type":"integer","description":"Number of user-specified stream filtering rules that were created.","format":"int32","example":1},"not_created":{"type":"integer","description":"Number of user-specified stream filtering rules that were not created.","format":"int32","example":1},"valid":{"type":"integer","description":"Number of valid user-specified stream filtering rules.","format":"int32","example":1},"invalid":{"type":"integer","description":"Number of invalid user-specified stream filtering rules.","format":"int32","example":1}}},{"type":"object","required":["deleted","not_deleted"],"properties":{"deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were deleted.","format":"int32"},"not_deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were not deleted.","format":"int32"}}}]}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"post":{"security":[{"BearerToken":[]}],"tags":["Tweets"],"summary":"Add/Delete rules","description":"Add or delete rules from a user's active rule set. Users can provide unique, optionally tagged rules to add. Users can delete their entire rule set or a subset specified by rule ids or values.","operationId":"addOrDeleteRules","parameters":[{"name":"dry_run","in":"query","description":"Dry Run can be used with both the add and delete action, with the expected result given, but without actually taking any action in the system (meaning the end state will always be as it was when the request was submitted). This is particularly useful to validate rule changes.","required":false,"schema":{"type":"boolean"}}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","oneOf":[{"type":"object","description":"A request to add a user-specified stream filtering rule.","required":["add"],"properties":{"add":{"type":"array","items":{"type":"object","description":"A user-provided stream filtering rule.","required":["value"],"properties":{"value":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"tag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"}}}}}},{"type":"object","description":"A response from deleting user-specified stream filtering rules.","required":["delete"],"properties":{"delete":{"type":"object","description":"IDs and values of all deleted user-specified stream filtering rules.","properties":{"ids":{"type":"array","description":"IDs of all deleted user-specified stream filtering rules.","items":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"}},"values":{"type":"array","description":"Values of all deleted user-specified stream filtering rules.","items":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"}}}}}}]}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","oneOf":[{"type":"object","description":"A response from adding user-specified stream filtering rules.","required":["data","meta"],"properties":{"data":{"type":"array","description":"All user-specified stream filtering rules that were created.","items":{"type":"object","description":"A user-provided stream filtering rule.","required":["value"],"properties":{"value":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"tag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"},"id":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"}}}},"meta":{"type":"object","required":["sent"],"properties":{"sent":{"type":"string"},"summary":{"type":"object","oneOf":[{"type":"object","description":"A summary of the results of the addition of user-specified stream filtering rules.","required":["created","not_created","valid","invalid"],"properties":{"created":{"type":"integer","description":"Number of user-specified stream filtering rules that were created.","format":"int32","example":1},"not_created":{"type":"integer","description":"Number of user-specified stream filtering rules that were not created.","format":"int32","example":1},"valid":{"type":"integer","description":"Number of valid user-specified stream filtering rules.","format":"int32","example":1},"invalid":{"type":"integer","description":"Number of invalid user-specified stream filtering rules.","format":"int32","example":1}}},{"type":"object","required":["deleted","not_deleted"],"properties":{"deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were deleted.","format":"int32"},"not_deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were not deleted.","format":"int32"}}}]}}}}},{"type":"object","required":["meta"],"properties":{"meta":{"type":"object","required":["sent"],"properties":{"sent":{"type":"string"},"summary":{"type":"object","oneOf":[{"type":"object","description":"A summary of the results of the addition of user-specified stream filtering rules.","required":["created","not_created","valid","invalid"],"properties":{"created":{"type":"integer","description":"Number of user-specified stream filtering rules that were created.","format":"int32","example":1},"not_created":{"type":"integer","description":"Number of user-specified stream filtering rules that were not created.","format":"int32","example":1},"valid":{"type":"integer","description":"Number of valid user-specified stream filtering rules.","format":"int32","example":1},"invalid":{"type":"integer","description":"Number of invalid user-specified stream filtering rules.","format":"int32","example":1}}},{"type":"object","required":["deleted","not_deleted"],"properties":{"deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were deleted.","format":"int32"},"not_deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were not deleted.","format":"int32"}}}]}}}}}]}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/sample/stream":{"get":{"security":[{"BearerToken":[]}],"tags":["Tweets"],"x-twitter-streaming":true,"summary":"Sample stream","description":"Streams a deterministic 1% of public Tweets.","operationId":"sampleStream","parameters":[{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}},{"name":"backfill_minutes","in":"query","description":"The number of minutes of backfill requested","required":false,"schema":{"type":"integer","format":"int32","minimum":0,"maximum":5}}],"responses":{"200":{"description":"The request was successful. Successful responses will return a stream of individual JSON Tweet payloads.","content":{"application/json":{"schema":{"type":"object","description":"A tweet or error that can be returned by the streaming tweet API.","oneOf":[{"type":"object","properties":{"data":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}]}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/openapi.json":{"get":{"tags":["General"],"summary":"Returns the open api spec document.","description":"Full open api spec in JSON format. (See https://github.com/OAI/OpenAPI-Specification/blob/master/README.md)","operationId":"getOpenApiSpec","parameters":[],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/2/users/{id}/tweets":{"get":{"tags":["Tweets"],"security":[{"BearerToken":[],"UserToken":[]}],"summary":"User Tweets timeline by User ID","description":"Returns a list of Tweets authored by the provided User ID","operationId":"usersIdTweets","parameters":[{"name":"id","in":"path","description":"The ID of the User to list Tweets of","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"since_id","in":"query","description":"The minimum Tweet ID to be included in the result set. This parameter takes precedence over start_time if both are specified.","required":false,"example":"791775337160081409","schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"name":"until_id","in":"query","description":"The maximum Tweet ID to be included in the result set. This parameter takes precedence over end_time if both are specified.","required":false,"example":"1346889436626259968","schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":5,"maximum":100}},{"name":"exclude","in":"query","style":"form","explode":false,"description":"The set of entities to exclude (e.g. 'replies' or 'retweets')","required":false,"schema":{"description":"The set of entities to exclude (e.g. 'replies' or 'retweets')","type":"array","items":{"type":"string","enum":["replies","retweets"]},"minItems":1,"uniqueItems":true,"example":["replies","retweets"]}},{"name":"pagination_token","in":"query","description":"This parameter is used to get the next 'page' of results.","required":false,"schema":{"type":"string","minLength":1}},{"name":"start_time","in":"query","description":"YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Tweets will be provided. The since_id parameter takes precedence if it is also specified.","required":false,"example":"2021-02-01T18:40:40.000Z","schema":{"type":"string","format":"date-time"}},{"name":"end_time","in":"query","description":"YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Tweets will be provided. The until_id parameter takes precedence if it is also specified.","required":false,"example":"2021-02-14T18:40:40.000Z","schema":{"type":"string","format":"date-time"}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"newest_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"oldest_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"Number of Tweets in result set","type":"integer","format":"int32"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/mentions":{"get":{"tags":["Tweets"],"security":[{"BearerToken":[],"UserToken":[]}],"summary":"User mention timeline by User ID","description":"Returns Tweet objects that mention username associated to the provided User ID","operationId":"usersIdMentions","parameters":[{"name":"id","in":"path","description":"The ID of the User to list mentions of","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"since_id","in":"query","description":"The minimum Tweet ID to be included in the result set. This parameter takes precedence over start_time if both are specified.","required":false,"example":"791775337160081409","schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"name":"until_id","in":"query","description":"The maximum Tweet ID to be included in the result set. This parameter takes precedence over end_time if both are specified.","required":false,"example":"1346889436626259968","schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":5,"maximum":100}},{"name":"pagination_token","in":"query","description":"This parameter is used to get the next 'page' of results.","required":false,"schema":{"type":"string","minLength":1}},{"name":"start_time","in":"query","description":"YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Tweets will be provided. The since_id parameter takes precedence if it is also specified.","required":false,"example":"2021-02-01T18:40:40.000Z","schema":{"type":"string","format":"date-time"}},{"name":"end_time","in":"query","description":"YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Tweets will be provided. The until_id parameter takes precedence if it is also specified.","required":false,"example":"2021-02-14T18:40:40.000Z","schema":{"type":"string","format":"date-time"}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"newest_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"oldest_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"Number of Tweets in result set","type":"integer","format":"int32"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/likes":{"post":{"tags":["Tweets"],"summary":"Causes the user (in the path) to like the specified tweet","description":"Causes the user (in the path) to like the specified tweet. The user in the path must match the user context authorizing the request.","operationId":"usersIdLike","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user that is requesting to like the tweet","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["tweet_id"],"properties":{"tweet_id":{"type":"string","pattern":"^[0-9]{1,19}$"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"liked":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/likes/{tweet_id}":{"delete":{"tags":["Tweets"],"summary":"Causes the user (in the path) to unlike the specified tweet","description":"Causes the user (in the path) to unlike the specified tweet. The user must match the user context authorizing the request","operationId":"usersIdUnlike","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user that is requesting to unlike the tweet","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"tweet_id","in":"path","description":"The ID of the tweet that the user is requesting to unlike","required":true,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"liked":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/liked_tweets":{"get":{"tags":["Tweets"],"summary":"Returns Tweet objects liked by the provided User ID","description":"Returns a list of Tweets liked by the provided User ID","operationId":"usersIdLikedTweets","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the User to list the liked Tweets of","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":5,"maximum":100}},{"name":"pagination_token","in":"query","description":"This parameter is used to get the next 'page' of results.","required":false,"schema":{"type":"string","minLength":1}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"Number of Tweets in result set","type":"integer","format":"int32"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/{id}/liking_users":{"get":{"tags":["Users"],"summary":"Returns user objects that have liked the provided Tweet ID","description":"Returns a list of users that have liked the provided Tweet ID","operationId":"tweetsIdLikingUsers","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the Tweet for which to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/{id}/retweeted_by":{"get":{"tags":["Users"],"summary":"Returns user objects that have retweeted the provided Tweet ID","description":"Returns a list of users that have retweeted the provided Tweet ID","operationId":"tweetsIdRetweetingUsers","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the Tweet for which to return results","required":true,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/retweets":{"post":{"tags":["Tweets"],"summary":"Causes the user (in the path) to retweet the specified tweet","description":"Causes the user (in the path) to retweet the specified tweet. The user in the path must match the user context authorizing the request.","operationId":"usersIdRetweets","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user that is requesting to retweet the tweet","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["tweet_id"],"properties":{"tweet_id":{"type":"string","pattern":"^[0-9]{1,19}$"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"retweeted":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/users/{id}/retweets/{source_tweet_id}":{"delete":{"tags":["Tweets"],"summary":"Causes the user (in the path) to unretweet the specified tweet","description":"Causes the user (in the path) to unretweet the specified tweet. The user must match the user context authorizing the request","operationId":"usersIdUnretweets","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the user that is requesting to unretweet the tweet","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}},{"name":"source_tweet_id","in":"path","description":"The ID of the tweet that the user is requesting to unretweet","required":true,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"retweeted":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/counts/recent":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Tweets"],"summary":"Recent search counts","description":"Returns Tweet Counts from the last 7 days that match a search query.","operationId":"tweetCountsRecentSearch","parameters":[{"in":"query","name":"query","description":"One query/rule/filter for matching Tweets. Up to 2048 characters.","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"example":"(from:TwitterDev OR from:TwitterAPI) has:media -is:retweet"}},{"in":"query","name":"start_time","description":"YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp (from most recent 7 days) from which the Tweets will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).","required":false,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"end_time","description":"YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Tweets will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).","required":false,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"since_id","description":"Returns results with a Tweet ID greater than (that is, more recent than) the specified ID.","required":false,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"in":"query","name":"until_id","description":"Returns results with a Tweet ID less than (that is, older than) the specified ID.","required":false,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"in":"query","name":"next_token","description":"This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"granularity","description":"The granularity for the search counts results.","required":false,"schema":{"type":"string","enum":["minute","hour","day"],"default":"hour"}}],"responses":{"200":{"description":"Recent tweet counts response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"Represent a Search Count Result","required":["end","start","tweet_count"],"properties":{"end":{"type":"string","format":"date-time","description":"The end time of the bucket"},"start":{"type":"string","format":"date-time","description":"The start time of the bucket"},"tweet_count":{"type":"integer","description":"The count for the bucket"}}},"minItems":1},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"next_token":{"description":"This value is used to get the next 'page' of results by providing it to the next_token parameter.","type":"string"},"total_tweet_count":{"description":"Sum of search query count results","type":"integer","format":"int32"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/tweets/counts/all":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Tweets"],"summary":"Full archive search counts","description":"Returns Tweet Counts that match a search query.","operationId":"tweetCountsFullArchiveSearch","parameters":[{"in":"query","name":"query","description":"One query/rule/filter for matching Tweets. Up to 2048 characters.","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"example":"(from:TwitterDev OR from:TwitterAPI) has:media -is:retweet"}},{"in":"query","name":"start_time","description":"YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp (from most recent 7 days) from which the Tweets will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).","required":false,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"end_time","description":"YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Tweets will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).","required":false,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"since_id","description":"Returns results with a Tweet ID greater than (that is, more recent than) the specified ID.","required":false,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"in":"query","name":"until_id","description":"Returns results with a Tweet ID less than (that is, older than) the specified ID.","required":false,"schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},{"in":"query","name":"next_token","description":"This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"granularity","description":"The granularity for the search counts results.","required":false,"schema":{"type":"string","enum":["minute","hour","day"],"default":"hour"}}],"responses":{"200":{"description":"Tweet counts response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"Represent a Search Count Result","required":["end","start","tweet_count"],"properties":{"end":{"type":"string","format":"date-time","description":"The end time of the bucket"},"start":{"type":"string","format":"date-time","description":"The start time of the bucket"},"tweet_count":{"type":"integer","description":"The count for the bucket"}}},"minItems":1},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"next_token":{"description":"This value is used to get the next 'page' of results by providing it to the next_token parameter.","type":"string"},"total_tweet_count":{"description":"Sum of search query count results","type":"integer","format":"int32"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/compliance/jobs":{"get":{"security":[{"BearerToken":[]}],"tags":["Compliance"],"summary":"List compliance jobs","description":"Returns recent compliance jobs for a given job type and optional job status","operationId":"listBatchComplianceJobs","parameters":[{"name":"type","in":"query","description":"Type of compliance job to list.","required":true,"style":"form","schema":{"description":"Type of compliance job to list.","type":"string","enum":["tweets","users"]}},{"name":"status","in":"query","description":"Status of compliance job to list.","required":false,"style":"form","schema":{"type":"string","enum":["created","in_progress","failed","complete"],"description":"Status of a compliance job"}}],"responses":{"200":{"description":"List compliance jobs response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","type","created_at","upload_url","download_url","upload_expires_at","download_expires_at","status"],"properties":{"id":{"type":"string","description":"Compliance Job ID","example":"1372966999991541762","pattern":"^[0-9]{1,19}$"},"type":{"description":"Type of compliance job to list.","type":"string","enum":["tweets","users"]},"created_at":{"type":"string","format":"date-time","description":"Creation time of the compliance job.","example":"2021-01-06T18:40:40.000Z"},"upload_url":{"type":"string","format":"uri","description":"URL to which the user will upload their tweet or user IDs"},"upload_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the upload URL","example":"2021-01-06T18:40:40.000Z"},"download_url":{"type":"string","format":"uri","description":"URL from which the user will retrieve their compliance results"},"download_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the download URL","example":"2021-01-06T18:40:40.000Z"},"name":{"type":"string","description":"User-provided name for a compliance job","example":"my-job","maxLength":64},"status":{"type":"string","enum":["created","in_progress","failed","complete"],"description":"Status of a compliance job"}}},"minItems":0},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":0}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"post":{"security":[{"BearerToken":[]}],"tags":["Compliance"],"summary":"Create compliance job","description":"Creates a compliance for the given job type","operationId":"createBatchComplianceJob","parameters":[],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","description":"A request to create a new batch compliance job.","required":["type"],"properties":{"type":{"description":"Type of compliance job to list.","type":"string","enum":["tweets","users"]},"resumable":{"description":"If true, this endpoint will return a pre-signed URL with resumable uploads enabled","type":"boolean"},"name":{"type":"string","description":"User-provided name for a compliance job","example":"my-job","maxLength":64}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["id","type","created_at","upload_url","download_url","upload_expires_at","download_expires_at","status"],"properties":{"id":{"type":"string","description":"Compliance Job ID","example":"1372966999991541762","pattern":"^[0-9]{1,19}$"},"type":{"description":"Type of compliance job to list.","type":"string","enum":["tweets","users"]},"created_at":{"type":"string","format":"date-time","description":"Creation time of the compliance job.","example":"2021-01-06T18:40:40.000Z"},"upload_url":{"type":"string","format":"uri","description":"URL to which the user will upload their tweet or user IDs"},"upload_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the upload URL","example":"2021-01-06T18:40:40.000Z"},"download_url":{"type":"string","format":"uri","description":"URL from which the user will retrieve their compliance results"},"download_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the download URL","example":"2021-01-06T18:40:40.000Z"},"name":{"type":"string","description":"User-provided name for a compliance job","example":"my-job","maxLength":64},"status":{"type":"string","enum":["created","in_progress","failed","complete"],"description":"Status of a compliance job"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/compliance/jobs/{id}":{"get":{"security":[{"BearerToken":[]}],"tags":["Compliance"],"summary":"Get compliance job","description":"Returns a single compliance job by ID","operationId":"getBatchComplianceJob","parameters":[{"name":"id","in":"path","description":"ID of the compliance job to retrieve.","required":true,"schema":{"type":"string","description":"Compliance Job ID","example":"1372966999991541762","pattern":"^[0-9]{1,19}$"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["id","type","created_at","upload_url","download_url","upload_expires_at","download_expires_at","status"],"properties":{"id":{"type":"string","description":"Compliance Job ID","example":"1372966999991541762","pattern":"^[0-9]{1,19}$"},"type":{"description":"Type of compliance job to list.","type":"string","enum":["tweets","users"]},"created_at":{"type":"string","format":"date-time","description":"Creation time of the compliance job.","example":"2021-01-06T18:40:40.000Z"},"upload_url":{"type":"string","format":"uri","description":"URL to which the user will upload their tweet or user IDs"},"upload_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the upload URL","example":"2021-01-06T18:40:40.000Z"},"download_url":{"type":"string","format":"uri","description":"URL from which the user will retrieve their compliance results"},"download_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the download URL","example":"2021-01-06T18:40:40.000Z"},"name":{"type":"string","description":"User-provided name for a compliance job","example":"my-job","maxLength":64},"status":{"type":"string","enum":["created","in_progress","failed","complete"],"description":"Status of a compliance job"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/lists":{"post":{"tags":["Lists"],"summary":"Create List","description":"Creates a new List.","operationId":"listIdCreate","security":[{"UserToken":[]}],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"private":{"type":"boolean"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/lists/{id}":{"delete":{"tags":["Lists"],"summary":"Delete List","description":"Delete a List that you own.","operationId":"listIdDelete","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the List to delete","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deleted":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"put":{"tags":["Lists"],"summary":"Update List","description":"Update a List that you own.","operationId":"listIdUpdate","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the List to modify","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"private":{"type":"boolean"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"updated":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"get":{"tags":["Lists"],"summary":"List lookup by List ID","description":"Returns a List","operationId":"listIdGet","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the List to get","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}},{"name":"list.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of List fields to display.","schema":{"description":"The fields available for a List object.","type":"array","items":{"type":"string","enum":["created_at","description","follower_count","id","member_count","name","owner_id","private"]},"minItems":1,"uniqueItems":true,"example":["created_at","description","follower_count","member_count","name","private"]}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [List](#List) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["owner_id"]},"minItems":1,"uniqueItems":true,"example":["owner_id"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/lists/{id}/followers":{"get":{"tags":["Users"],"summary":"Returns user objects that follow a List by the provided List ID","description":"Returns a list of users that follow a List by the provided List ID","operationId":"listGetFollowers","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the List for which to return followers","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","description":"This parameter is used to get a specified 'page' of results.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [User](#User) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["pinned_tweet_id"]},"minItems":1,"uniqueItems":true,"example":["pinned_tweet_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^-?[0-9]{1,19}$"},"next_token":{"description":"The next token","type":"string","pattern":"^-?[0-9]{1,19}$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/lists/{id}/members":{"post":{"tags":["Lists"],"summary":"Add a List member","description":"Causes a user to become a member of a List.","operationId":"listAddMember","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the List to add a member","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}}}},"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"member":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}},"get":{"tags":["Users"],"summary":"Returns user objects that are members of a List by the provided List ID","description":"Returns a list of users that are members of a List by the provided List ID","operationId":"listGetMembers","security":[{"BearerToken":[],"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the List for which to return members","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","description":"This parameter is used to get a specified 'page' of results.","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [User](#User) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["pinned_tweet_id"]},"minItems":1,"uniqueItems":true,"example":["pinned_tweet_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^-?[0-9]{1,19}$"},"next_token":{"description":"The next token","type":"string","pattern":"^-?[0-9]{1,19}$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/lists/{id}/members/{user_id}":{"delete":{"tags":["Lists"],"summary":"Remove a List member","description":"Causes a user to be removed from the members of a List.","operationId":"listRemoveMember","security":[{"UserToken":[]}],"parameters":[{"name":"id","in":"path","description":"The ID of the List to remove a member","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}},{"name":"user_id","in":"path","description":"The ID of user that will be removed from the List","required":true,"schema":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"member":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/lists/{id}/tweets":{"get":{"tags":["Tweets"],"security":[{"BearerToken":[],"UserToken":[]}],"summary":"List Tweets timeline by List ID","description":"Returns a list of Tweets associated with the provided List ID","operationId":"listsIdTweets","parameters":[{"name":"id","in":"path","description":"The ID of the List to list Tweets of","required":true,"schema":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}},{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":100,"default":100}},{"name":"pagination_token","in":"query","description":"This parameter is used to get the next 'page' of results.","required":false,"schema":{"type":"string","minLength":1}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"Number of Tweets in result set","type":"integer","format":"int32"}}}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/spaces/{id}":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Spaces"],"summary":"Space lookup by Space ID","description":"Returns a variety of information about the Space specified by the requested ID","operationId":"findSpaceById","parameters":[{"description":"The space id to be retrieved","in":"path","name":"id","required":true,"schema":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"}},{"name":"space.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Space fields to display.","schema":{"description":"The fields available for a Space object.","type":"array","items":{"type":"string","enum":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]},"minItems":1,"uniqueItems":true,"example":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Space](#Space) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["creator_id","host_ids","invited_user_ids","speaker_ids"]},"minItems":1,"uniqueItems":true,"example":["creator_id","host_ids","invited_user_ids","speaker_ids"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"","required":["id","state"],"properties":{"id":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"},"state":{"description":"The current state of the space.","enum":["live","scheduled","ended"],"example":"live","type":"string"},"started_at":{"description":"When the space was started as a date string","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"is_ticketed":{"description":"Denotes if the space is a ticketed space","example":"false","type":"boolean"},"participant_count":{"description":"The number of participants in a space","example":10,"format":"int32","type":"integer"},"title":{"description":"The title of the space","example":"Spaces are Awesome","type":"string"},"host_ids":{"description":"The user ids for the hosts of the space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"updated_at":{"description":"When the space was last updated","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"created_at":{"description":"Creation time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"creator_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"lang":{"description":"The language of the space","example":"en","type":"string"},"speaker_ids":{"description":"An array of user ids for people who were speakers in a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"invited_user_ids":{"description":"An array of user ids for people who were invited to a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"scheduled_start":{"description":"A date time stamp for when a space is scheduled to begin","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"ended_at":{"description":"End time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"topics":{"description":"The topics of a space, as selected by its creator","items":{"description":"The Twitter Topic object","type":"object","required":["id","name"],"properties":{"id":{"type":"string","description":"An ID suitable for use in the REST API."},"description":{"type":"string","description":"The description of the given topic."},"name":{"type":"string","description":"The name of the given topic."}},"example":{"id":"848920371311001600","description":"All about technology","name":"Technology"}},"type":"array"}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/spaces":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Spaces"],"summary":"Space lookup up Space IDs","description":"Returns a variety of information about the Spaces specified by the requested IDs","operationId":"findSpacesByIds","parameters":[{"in":"query","name":"ids","description":"A list of space ids","required":true,"schema":{"minItems":1,"type":"array","items":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"}}},{"name":"space.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Space fields to display.","schema":{"description":"The fields available for a Space object.","type":"array","items":{"type":"string","enum":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]},"minItems":1,"uniqueItems":true,"example":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Space](#Space) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["creator_id","host_ids","invited_user_ids","speaker_ids"]},"minItems":1,"uniqueItems":true,"example":["creator_id","host_ids","invited_user_ids","speaker_ids"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"","required":["id","state"],"properties":{"id":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"},"state":{"description":"The current state of the space.","enum":["live","scheduled","ended"],"example":"live","type":"string"},"started_at":{"description":"When the space was started as a date string","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"is_ticketed":{"description":"Denotes if the space is a ticketed space","example":"false","type":"boolean"},"participant_count":{"description":"The number of participants in a space","example":10,"format":"int32","type":"integer"},"title":{"description":"The title of the space","example":"Spaces are Awesome","type":"string"},"host_ids":{"description":"The user ids for the hosts of the space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"updated_at":{"description":"When the space was last updated","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"created_at":{"description":"Creation time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"creator_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"lang":{"description":"The language of the space","example":"en","type":"string"},"speaker_ids":{"description":"An array of user ids for people who were speakers in a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"invited_user_ids":{"description":"An array of user ids for people who were invited to a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"scheduled_start":{"description":"A date time stamp for when a space is scheduled to begin","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"ended_at":{"description":"End time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"topics":{"description":"The topics of a space, as selected by its creator","items":{"description":"The Twitter Topic object","type":"object","required":["id","name"],"properties":{"id":{"type":"string","description":"An ID suitable for use in the REST API."},"description":{"type":"string","description":"The description of the given topic."},"name":{"type":"string","description":"The name of the given topic."}},"example":{"id":"848920371311001600","description":"All about technology","name":"Technology"}},"type":"array"}}},"minItems":0},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/spaces/by/creator_ids":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Spaces"],"summary":"Space lookup by their creators","description":"Returns a variety of information about the Spaces created by the provided User IDs","operationId":"findSpacesByCreatorIds","parameters":[{"in":"query","name":"user_ids","description":"The users to search through","required":true,"schema":{"type":"array","minItems":1,"items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}},{"name":"space.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Space fields to display.","schema":{"description":"The fields available for a Space object.","type":"array","items":{"type":"string","enum":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]},"minItems":1,"uniqueItems":true,"example":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Space](#Space) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["creator_id","host_ids","invited_user_ids","speaker_ids"]},"minItems":1,"uniqueItems":true,"example":["creator_id","host_ids","invited_user_ids","speaker_ids"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"","required":["id","state"],"properties":{"id":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"},"state":{"description":"The current state of the space.","enum":["live","scheduled","ended"],"example":"live","type":"string"},"started_at":{"description":"When the space was started as a date string","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"is_ticketed":{"description":"Denotes if the space is a ticketed space","example":"false","type":"boolean"},"participant_count":{"description":"The number of participants in a space","example":10,"format":"int32","type":"integer"},"title":{"description":"The title of the space","example":"Spaces are Awesome","type":"string"},"host_ids":{"description":"The user ids for the hosts of the space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"updated_at":{"description":"When the space was last updated","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"created_at":{"description":"Creation time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"creator_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"lang":{"description":"The language of the space","example":"en","type":"string"},"speaker_ids":{"description":"An array of user ids for people who were speakers in a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"invited_user_ids":{"description":"An array of user ids for people who were invited to a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"scheduled_start":{"description":"A date time stamp for when a space is scheduled to begin","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"ended_at":{"description":"End time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"topics":{"description":"The topics of a space, as selected by its creator","items":{"description":"The Twitter Topic object","type":"object","required":["id","name"],"properties":{"id":{"type":"string","description":"An ID suitable for use in the REST API."},"description":{"type":"string","description":"The description of the given topic."},"name":{"type":"string","description":"The name of the given topic."}},"example":{"id":"848920371311001600","description":"All about technology","name":"Technology"}},"type":"array"}}},"minItems":0},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/spaces/search":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Spaces"],"summary":"Search for Spaces","description":"Returns Spaces that match the provided query.","operationId":"searchSpaces","parameters":[{"in":"query","name":"query","description":"The search query","required":true,"example":"crypto","schema":{"description":"The query to use in the Spaces search endpoint","example":"crypto","type":"string"}},{"in":"query","name":"state","description":"The state of spaces to search for","required":false,"schema":{"description":"The current state of the space.","enum":["live","scheduled","all"],"example":"live","default":"all","type":"string"}},{"in":"query","name":"max_results","description":"The number of results to return. The maximum for this value is 100.","required":false,"schema":{"description":"The number of results to return","example":25,"minimum":1,"maximum":100,"type":"integer","format":"int32"}},{"name":"space.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Space fields to display.","schema":{"description":"The fields available for a Space object.","type":"array","items":{"type":"string","enum":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]},"minItems":1,"uniqueItems":true,"example":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]}},{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Space](#Space) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["creator_id","host_ids","invited_user_ids","speaker_ids"]},"minItems":1,"uniqueItems":true,"example":["creator_id","host_ids","invited_user_ids","speaker_ids"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"","required":["id","state"],"properties":{"id":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"},"state":{"description":"The current state of the space.","enum":["live","scheduled","ended"],"example":"live","type":"string"},"started_at":{"description":"When the space was started as a date string","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"is_ticketed":{"description":"Denotes if the space is a ticketed space","example":"false","type":"boolean"},"participant_count":{"description":"The number of participants in a space","example":10,"format":"int32","type":"integer"},"title":{"description":"The title of the space","example":"Spaces are Awesome","type":"string"},"host_ids":{"description":"The user ids for the hosts of the space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"updated_at":{"description":"When the space was last updated","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"created_at":{"description":"Creation time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"creator_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"lang":{"description":"The language of the space","example":"en","type":"string"},"speaker_ids":{"description":"An array of user ids for people who were speakers in a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"invited_user_ids":{"description":"An array of user ids for people who were invited to a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"scheduled_start":{"description":"A date time stamp for when a space is scheduled to begin","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"ended_at":{"description":"End time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"topics":{"description":"The topics of a space, as selected by its creator","items":{"description":"The Twitter Topic object","type":"object","required":["id","name"],"properties":{"id":{"type":"string","description":"An ID suitable for use in the REST API."},"description":{"type":"string","description":"The description of the given topic."},"name":{"type":"string","description":"The name of the given topic."}},"example":{"id":"848920371311001600","description":"All about technology","name":"Technology"}},"type":"array"}}},"minItems":0},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}},"/2/spaces/{id}/buyers":{"get":{"security":[{"BearerToken":[],"UserToken":[]}],"tags":["Spaces","Tweets"],"summary":"Retrieve the list of users who purchased a ticket to the given space","description":"Retrieves the list of users who purchased a ticket to the given space","operationId":"spaceBuyers","parameters":[{"in":"path","name":"id","description":"The space id from which tweets will be retrieved","required":true,"example":"1YqKDqWqdPLsV","schema":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"}},{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}}],"responses":{"200":{"description":"The request was successful","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}}}},"default":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}}}}},"components":{"securitySchemes":{"BearerToken":{"type":"http","scheme":"bearer"},"UserToken":{"type":"http","scheme":"OAuth"}},"schemas":{"MediaHeight":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"MediaWidth":{"type":"integer","minimum":0,"description":"The width of the media in pixels"},"HTTPStatusCode":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"ContextAnnotation":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"ContextAnnotationDomainFields":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"ContextAnnotationEntityFields":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}},"URL":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"EntityIndicesInclusiveExclusive":{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},"EntityIndicesInclusiveInclusive":{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is inclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is inclusive.","example":61}}},"URLFields":{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}},"UrlEntity":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"URLImage":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"HashtagFields":{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}},"HashtagEntity":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"CashtagFields":{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}},"CashtagEntity":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"MentionFields":{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}},"MentionEntity":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"FullTextEntities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"TweetID":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"TweetText":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"UserID":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"SpaceID":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"},"ReplySettings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"Error":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}},"Expansions":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"Tweet":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"User":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"UserName":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"MultiUserLookupResponse":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"SingleUserLookupResponse":{"type":"object","properties":{"data":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"MultiTweetLookupResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"SingleTweetLookupResponse":{"type":"object","properties":{"data":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"Point":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"Position":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]},"Geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}},"PlaceId":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"Place":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"PlaceType":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"Poll":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"PollId":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"PollOption":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"DurationMinutes":{"type":"integer","format":"int32","minimum":5,"maximum":10080,"description":"Duration of the poll in minutes."},"List":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"ListID":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"ListCreateRequest":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"private":{"type":"boolean"}}},"ListCreateResponse":{"type":"object","properties":{"data":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"ListDeleteResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"deleted":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"ListUpdateRequest":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"private":{"type":"boolean"}}},"ListUpdateResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"updated":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"ListAddMemberRequest":{"type":"object","properties":{"user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}},"ListMemberResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"member":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"ListFollowRequest":{"type":"object","properties":{"list_id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}}},"ListFollowedResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"following":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"ListPinRequest":{"type":"object","properties":{"list_id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"}}},"ListPinnedResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"pinned":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"SingleListLookupResponse":{"type":"object","properties":{"data":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"MultiListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"minItems":0},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^-?[0-9]{1,19}$"},"next_token":{"description":"The next token","type":"string","pattern":"^-?[0-9]{1,19}$"},"result_count":{"description":"The number of list results returned in this response","type":"integer"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"MultiListNoPaginationResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"A Twitter List is a curated group of accounts.","required":["id","name"],"properties":{"id":{"type":"string","description":"The unique identifier of this List.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"name":{"type":"string","description":"The name of this List."},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"follower_count":{"type":"integer"},"member_count":{"type":"integer"},"owner_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"private":{"type":"boolean"}}},"minItems":0},"meta":{"type":"object","properties":{"result_count":{"description":"The number of list results returned in this response","type":"integer"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"TweetDeleteResponse":{"type":"object","properties":{"data":{"type":"object","required":["deleted"],"properties":{"deleted":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"TweetCreateResponse":{"type":"object","properties":{"data":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"CommonMediaFields":{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"Media":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"MediaId":{"type":"string","description":"The unique identifier of this Media.","pattern":"^[0-9]{1,19}$","example":"1146654567674912769"},"Photo":{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},"Video":{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},"AnimatedGif":{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]},"MediaKey":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"TweetWithheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"UserWithheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"CountryCode":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"ProblemFields":{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},"GenericProblem":{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},"InvalidRequestProblem":{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},"ResourceNotFoundProblem":{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},"ResourceUnauthorizedProblem":{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},"ResourceUnavailableProblem":{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},"FieldUnauthorizedProblem":{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},"ClientForbiddenProblem":{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},"DisallowedResourceProblem":{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},"UnsupportedAuthenticationProblem":{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},"UsageCapExceededProblem":{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},"ConnectionExceptionProblem":{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},"ClientDisconnectedProblem":{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},"OperationalDisconnectProblem":{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},"RulesCapProblem":{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},"InvalidRuleProblem":{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},"DuplicateRuleProblem":{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},"ConflictProblem":{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},"NonCompliantRulesProblem":{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]},"Problem":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"TweetSearchResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"newest_id":{"type":"string","pattern":"^[0-9]{1,19}$","description":"Most recent Tweet Id returned by search query"},"oldest_id":{"type":"string","pattern":"^[0-9]{1,19}$","description":"Oldest Tweet Id returned by search query"},"next_token":{"description":"This value is used to get the next 'page' of results by providing it to the next_token parameter.","type":"string"},"result_count":{"description":"Number of search query results","type":"integer","format":"int32"}}}}},"StreamingTweet":{"type":"object","description":"A tweet or error that can be returned by the streaming tweet API.","oneOf":[{"type":"object","properties":{"data":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}]},"FilteredStreamingTweet":{"type":"object","description":"A tweet or error that can be returned by the streaming tweet API","oneOf":[{"type":"object","description":"The values returned with a successful streamed tweet. Includes the user provided rules that the tweet matched.","required":["data","matching_rules"],"properties":{"data":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"matching_rules":{"type":"array","description":"The list of rules which matched the tweet","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"},"tag":{"type":"string","description":"The user-supplied tag assigned to the rule which matched"}}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}}}},{"type":"object","required":["errors"],"properties":{"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}]},"RuleId":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"},"Rule":{"type":"object","description":"A user-provided stream filtering rule.","required":["value"],"properties":{"value":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"tag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"},"id":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"}}},"RuleNoId":{"type":"object","description":"A user-provided stream filtering rule.","required":["value"],"properties":{"value":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"tag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"}}},"RuleTag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"},"RuleValue":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"RulesResponseMetadata":{"type":"object","required":["sent"],"properties":{"sent":{"type":"string"},"summary":{"type":"object","oneOf":[{"type":"object","description":"A summary of the results of the addition of user-specified stream filtering rules.","required":["created","not_created","valid","invalid"],"properties":{"created":{"type":"integer","description":"Number of user-specified stream filtering rules that were created.","format":"int32","example":1},"not_created":{"type":"integer","description":"Number of user-specified stream filtering rules that were not created.","format":"int32","example":1},"valid":{"type":"integer","description":"Number of valid user-specified stream filtering rules.","format":"int32","example":1},"invalid":{"type":"integer","description":"Number of invalid user-specified stream filtering rules.","format":"int32","example":1}}},{"type":"object","required":["deleted","not_deleted"],"properties":{"deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were deleted.","format":"int32"},"not_deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were not deleted.","format":"int32"}}}]}}},"RulesRequestSummary":{"type":"object","oneOf":[{"type":"object","description":"A summary of the results of the addition of user-specified stream filtering rules.","required":["created","not_created","valid","invalid"],"properties":{"created":{"type":"integer","description":"Number of user-specified stream filtering rules that were created.","format":"int32","example":1},"not_created":{"type":"integer","description":"Number of user-specified stream filtering rules that were not created.","format":"int32","example":1},"valid":{"type":"integer","description":"Number of valid user-specified stream filtering rules.","format":"int32","example":1},"invalid":{"type":"integer","description":"Number of invalid user-specified stream filtering rules.","format":"int32","example":1}}},{"type":"object","required":["deleted","not_deleted"],"properties":{"deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were deleted.","format":"int32"},"not_deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were not deleted.","format":"int32"}}}]},"AddOrDeleteRulesRequest":{"type":"object","oneOf":[{"type":"object","description":"A request to add a user-specified stream filtering rule.","required":["add"],"properties":{"add":{"type":"array","items":{"type":"object","description":"A user-provided stream filtering rule.","required":["value"],"properties":{"value":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"tag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"}}}}}},{"type":"object","description":"A response from deleting user-specified stream filtering rules.","required":["delete"],"properties":{"delete":{"type":"object","description":"IDs and values of all deleted user-specified stream filtering rules.","properties":{"ids":{"type":"array","description":"IDs of all deleted user-specified stream filtering rules.","items":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"}},"values":{"type":"array","description":"Values of all deleted user-specified stream filtering rules.","items":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"}}}}}}]},"AddOrDeleteRulesResponse":{"type":"object","oneOf":[{"type":"object","description":"A response from adding user-specified stream filtering rules.","required":["data","meta"],"properties":{"data":{"type":"array","description":"All user-specified stream filtering rules that were created.","items":{"type":"object","description":"A user-provided stream filtering rule.","required":["value"],"properties":{"value":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"tag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"},"id":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"}}}},"meta":{"type":"object","required":["sent"],"properties":{"sent":{"type":"string"},"summary":{"type":"object","oneOf":[{"type":"object","description":"A summary of the results of the addition of user-specified stream filtering rules.","required":["created","not_created","valid","invalid"],"properties":{"created":{"type":"integer","description":"Number of user-specified stream filtering rules that were created.","format":"int32","example":1},"not_created":{"type":"integer","description":"Number of user-specified stream filtering rules that were not created.","format":"int32","example":1},"valid":{"type":"integer","description":"Number of valid user-specified stream filtering rules.","format":"int32","example":1},"invalid":{"type":"integer","description":"Number of invalid user-specified stream filtering rules.","format":"int32","example":1}}},{"type":"object","required":["deleted","not_deleted"],"properties":{"deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were deleted.","format":"int32"},"not_deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were not deleted.","format":"int32"}}}]}}}}},{"type":"object","required":["meta"],"properties":{"meta":{"type":"object","required":["sent"],"properties":{"sent":{"type":"string"},"summary":{"type":"object","oneOf":[{"type":"object","description":"A summary of the results of the addition of user-specified stream filtering rules.","required":["created","not_created","valid","invalid"],"properties":{"created":{"type":"integer","description":"Number of user-specified stream filtering rules that were created.","format":"int32","example":1},"not_created":{"type":"integer","description":"Number of user-specified stream filtering rules that were not created.","format":"int32","example":1},"valid":{"type":"integer","description":"Number of valid user-specified stream filtering rules.","format":"int32","example":1},"invalid":{"type":"integer","description":"Number of invalid user-specified stream filtering rules.","format":"int32","example":1}}},{"type":"object","required":["deleted","not_deleted"],"properties":{"deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were deleted.","format":"int32"},"not_deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were not deleted.","format":"int32"}}}]}}}}}]},"AddRulesRequest":{"type":"object","description":"A request to add a user-specified stream filtering rule.","required":["add"],"properties":{"add":{"type":"array","items":{"type":"object","description":"A user-provided stream filtering rule.","required":["value"],"properties":{"value":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"tag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"}}}}}},"AddRulesResponse":{"type":"object","description":"A response from adding user-specified stream filtering rules.","required":["data","meta"],"properties":{"data":{"type":"array","description":"All user-specified stream filtering rules that were created.","items":{"type":"object","description":"A user-provided stream filtering rule.","required":["value"],"properties":{"value":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"},"tag":{"type":"string","description":"A tag meant for the labeling of user provided rules.","example":"Non-retweeted coffee tweets"},"id":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"}}}},"meta":{"type":"object","required":["sent"],"properties":{"sent":{"type":"string"},"summary":{"type":"object","oneOf":[{"type":"object","description":"A summary of the results of the addition of user-specified stream filtering rules.","required":["created","not_created","valid","invalid"],"properties":{"created":{"type":"integer","description":"Number of user-specified stream filtering rules that were created.","format":"int32","example":1},"not_created":{"type":"integer","description":"Number of user-specified stream filtering rules that were not created.","format":"int32","example":1},"valid":{"type":"integer","description":"Number of valid user-specified stream filtering rules.","format":"int32","example":1},"invalid":{"type":"integer","description":"Number of invalid user-specified stream filtering rules.","format":"int32","example":1}}},{"type":"object","required":["deleted","not_deleted"],"properties":{"deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were deleted.","format":"int32"},"not_deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were not deleted.","format":"int32"}}}]}}}}},"DeleteRulesRequest":{"type":"object","description":"A response from deleting user-specified stream filtering rules.","required":["delete"],"properties":{"delete":{"type":"object","description":"IDs and values of all deleted user-specified stream filtering rules.","properties":{"ids":{"type":"array","description":"IDs of all deleted user-specified stream filtering rules.","items":{"type":"string","description":"Unique identifier of this rule.","pattern":"^[0-9]{1,19}$","example":"120897978112909812"}},"values":{"type":"array","description":"Values of all deleted user-specified stream filtering rules.","items":{"type":"string","description":"The filterlang value of the rule.","example":"coffee -is:retweet"}}}}}},"DeleteRulesResponse":{"type":"object","required":["meta"],"properties":{"meta":{"type":"object","required":["sent"],"properties":{"sent":{"type":"string"},"summary":{"type":"object","oneOf":[{"type":"object","description":"A summary of the results of the addition of user-specified stream filtering rules.","required":["created","not_created","valid","invalid"],"properties":{"created":{"type":"integer","description":"Number of user-specified stream filtering rules that were created.","format":"int32","example":1},"not_created":{"type":"integer","description":"Number of user-specified stream filtering rules that were not created.","format":"int32","example":1},"valid":{"type":"integer","description":"Number of valid user-specified stream filtering rules.","format":"int32","example":1},"invalid":{"type":"integer","description":"Number of invalid user-specified stream filtering rules.","format":"int32","example":1}}},{"type":"object","required":["deleted","not_deleted"],"properties":{"deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were deleted.","format":"int32"},"not_deleted":{"type":"integer","description":"Number of user-specified stream filtering rules that were not deleted.","format":"int32"}}}]}}}}},"GenericTweetsTimelineResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"newest_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"oldest_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"Number of Tweets in result set","type":"integer","format":"int32"}}}}},"UsersBlockingMutationResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"blocking":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"GenericMultipleUsersLookupResponse":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}},"ListLookupMultipleUsersLookupResponse":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^-?[0-9]{1,19}$"},"next_token":{"description":"The next token","type":"string","pattern":"^-?[0-9]{1,19}$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}},"UsersMutingMutationResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"muting":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"UsersFollowingLookupResponse":{"type":"object","properties":{"data":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"previous_token":{"description":"The previous token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"next_token":{"description":"The next token","type":"string","pattern":"^[a-zA-Z0-9]+$"},"result_count":{"description":"The number of user results returned in this response","type":"integer"}}}}},"UsersFollowingCreateResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"following":{"type":"boolean"},"pending_follow":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"UsersFollowingDeleteResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"following":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"UsersLikesCreateRequest":{"type":"object","required":["tweet_id"],"properties":{"tweet_id":{"type":"string","pattern":"^[0-9]{1,19}$"}}},"UsersLikesCreateResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"liked":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"UsersLikesDeleteResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"liked":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"UsersRetweetsCreateRequest":{"type":"object","required":["tweet_id"],"properties":{"tweet_id":{"type":"string","pattern":"^[0-9]{1,19}$"}}},"UsersRetweetsCreateResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"retweeted":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"UsersRetweetsDeleteResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"retweeted":{"type":"boolean"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"TweetCountsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"Represent a Search Count Result","required":["end","start","tweet_count"],"properties":{"end":{"type":"string","format":"date-time","description":"The end time of the bucket"},"start":{"type":"string","format":"date-time","description":"The start time of the bucket"},"tweet_count":{"type":"integer","description":"The count for the bucket"}}},"minItems":1},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1},"meta":{"type":"object","properties":{"next_token":{"description":"This value is used to get the next 'page' of results by providing it to the next_token parameter.","type":"string"},"total_tweet_count":{"description":"Sum of search query count results","type":"integer","format":"int32"}}}}},"SearchCount":{"type":"object","description":"Represent a Search Count Result","required":["end","start","tweet_count"],"properties":{"end":{"type":"string","format":"date-time","description":"The end time of the bucket"},"start":{"type":"string","format":"date-time","description":"The start time of the bucket"},"tweet_count":{"type":"integer","description":"The count for the bucket"}}},"Start":{"type":"string","format":"date-time","description":"The start time of the bucket"},"End":{"type":"string","format":"date-time","description":"The end time of the bucket"},"TweetCount":{"type":"integer","description":"The count for the bucket"},"Granularity":{"type":"string","enum":["minute","hour","day"],"default":"hour"},"JobId":{"type":"string","description":"Compliance Job ID","example":"1372966999991541762","pattern":"^[0-9]{1,19}$"},"CreatedAt":{"type":"string","format":"date-time","description":"Creation time of the compliance job.","example":"2021-01-06T18:40:40.000Z"},"UploadUrl":{"type":"string","format":"uri","description":"URL to which the user will upload their tweet or user IDs"},"DownloadUrl":{"type":"string","format":"uri","description":"URL from which the user will retrieve their compliance results"},"UploadExpiration":{"type":"string","format":"date-time","description":"Expiration time of the upload URL","example":"2021-01-06T18:40:40.000Z"},"DownloadExpiration":{"type":"string","format":"date-time","description":"Expiration time of the download URL","example":"2021-01-06T18:40:40.000Z"},"ComplianceJobName":{"type":"string","description":"User-provided name for a compliance job","example":"my-job","maxLength":64},"ComplianceJobStatus":{"type":"string","enum":["created","in_progress","failed","complete"],"description":"Status of a compliance job"},"ComplianceJobType":{"description":"Type of compliance job to list.","type":"string","enum":["tweets","users"]},"ComplianceJob":{"type":"object","required":["id","type","created_at","upload_url","download_url","upload_expires_at","download_expires_at","status"],"properties":{"id":{"type":"string","description":"Compliance Job ID","example":"1372966999991541762","pattern":"^[0-9]{1,19}$"},"type":{"description":"Type of compliance job to list.","type":"string","enum":["tweets","users"]},"created_at":{"type":"string","format":"date-time","description":"Creation time of the compliance job.","example":"2021-01-06T18:40:40.000Z"},"upload_url":{"type":"string","format":"uri","description":"URL to which the user will upload their tweet or user IDs"},"upload_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the upload URL","example":"2021-01-06T18:40:40.000Z"},"download_url":{"type":"string","format":"uri","description":"URL from which the user will retrieve their compliance results"},"download_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the download URL","example":"2021-01-06T18:40:40.000Z"},"name":{"type":"string","description":"User-provided name for a compliance job","example":"my-job","maxLength":64},"status":{"type":"string","enum":["created","in_progress","failed","complete"],"description":"Status of a compliance job"}}},"SingleComplianceJobResponse":{"type":"object","properties":{"data":{"type":"object","required":["id","type","created_at","upload_url","download_url","upload_expires_at","download_expires_at","status"],"properties":{"id":{"type":"string","description":"Compliance Job ID","example":"1372966999991541762","pattern":"^[0-9]{1,19}$"},"type":{"description":"Type of compliance job to list.","type":"string","enum":["tweets","users"]},"created_at":{"type":"string","format":"date-time","description":"Creation time of the compliance job.","example":"2021-01-06T18:40:40.000Z"},"upload_url":{"type":"string","format":"uri","description":"URL to which the user will upload their tweet or user IDs"},"upload_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the upload URL","example":"2021-01-06T18:40:40.000Z"},"download_url":{"type":"string","format":"uri","description":"URL from which the user will retrieve their compliance results"},"download_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the download URL","example":"2021-01-06T18:40:40.000Z"},"name":{"type":"string","description":"User-provided name for a compliance job","example":"my-job","maxLength":64},"status":{"type":"string","enum":["created","in_progress","failed","complete"],"description":"Status of a compliance job"}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"MultiComplianceJobResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","type","created_at","upload_url","download_url","upload_expires_at","download_expires_at","status"],"properties":{"id":{"type":"string","description":"Compliance Job ID","example":"1372966999991541762","pattern":"^[0-9]{1,19}$"},"type":{"description":"Type of compliance job to list.","type":"string","enum":["tweets","users"]},"created_at":{"type":"string","format":"date-time","description":"Creation time of the compliance job.","example":"2021-01-06T18:40:40.000Z"},"upload_url":{"type":"string","format":"uri","description":"URL to which the user will upload their tweet or user IDs"},"upload_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the upload URL","example":"2021-01-06T18:40:40.000Z"},"download_url":{"type":"string","format":"uri","description":"URL from which the user will retrieve their compliance results"},"download_expires_at":{"type":"string","format":"date-time","description":"Expiration time of the download URL","example":"2021-01-06T18:40:40.000Z"},"name":{"type":"string","description":"User-provided name for a compliance job","example":"my-job","maxLength":64},"status":{"type":"string","enum":["created","in_progress","failed","complete"],"description":"Status of a compliance job"}}},"minItems":0},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":0}}},"Space":{"type":"object","description":"","required":["id","state"],"properties":{"id":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"},"state":{"description":"The current state of the space.","enum":["live","scheduled","ended"],"example":"live","type":"string"},"started_at":{"description":"When the space was started as a date string","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"is_ticketed":{"description":"Denotes if the space is a ticketed space","example":"false","type":"boolean"},"participant_count":{"description":"The number of participants in a space","example":10,"format":"int32","type":"integer"},"title":{"description":"The title of the space","example":"Spaces are Awesome","type":"string"},"host_ids":{"description":"The user ids for the hosts of the space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"updated_at":{"description":"When the space was last updated","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"created_at":{"description":"Creation time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"creator_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"lang":{"description":"The language of the space","example":"en","type":"string"},"speaker_ids":{"description":"An array of user ids for people who were speakers in a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"invited_user_ids":{"description":"An array of user ids for people who were invited to a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"scheduled_start":{"description":"A date time stamp for when a space is scheduled to begin","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"ended_at":{"description":"End time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"topics":{"description":"The topics of a space, as selected by its creator","items":{"description":"The Twitter Topic object","type":"object","required":["id","name"],"properties":{"id":{"type":"string","description":"An ID suitable for use in the REST API."},"description":{"type":"string","description":"The description of the given topic."},"name":{"type":"string","description":"The name of the given topic."}},"example":{"id":"848920371311001600","description":"All about technology","name":"Technology"}},"type":"array"}}},"SingleSpaceLookupResponse":{"type":"object","properties":{"data":{"type":"object","description":"","required":["id","state"],"properties":{"id":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"},"state":{"description":"The current state of the space.","enum":["live","scheduled","ended"],"example":"live","type":"string"},"started_at":{"description":"When the space was started as a date string","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"is_ticketed":{"description":"Denotes if the space is a ticketed space","example":"false","type":"boolean"},"participant_count":{"description":"The number of participants in a space","example":10,"format":"int32","type":"integer"},"title":{"description":"The title of the space","example":"Spaces are Awesome","type":"string"},"host_ids":{"description":"The user ids for the hosts of the space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"updated_at":{"description":"When the space was last updated","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"created_at":{"description":"Creation time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"creator_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"lang":{"description":"The language of the space","example":"en","type":"string"},"speaker_ids":{"description":"An array of user ids for people who were speakers in a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"invited_user_ids":{"description":"An array of user ids for people who were invited to a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"scheduled_start":{"description":"A date time stamp for when a space is scheduled to begin","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"ended_at":{"description":"End time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"topics":{"description":"The topics of a space, as selected by its creator","items":{"description":"The Twitter Topic object","type":"object","required":["id","name"],"properties":{"id":{"type":"string","description":"An ID suitable for use in the REST API."},"description":{"type":"string","description":"The description of the given topic."},"name":{"type":"string","description":"The name of the given topic."}},"example":{"id":"848920371311001600","description":"All about technology","name":"Technology"}},"type":"array"}}},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}},"MultiSpaceLookupResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","description":"","required":["id","state"],"properties":{"id":{"description":"The unique identifier of this Space.","example":"1SLjjRYNejbKM","pattern":"^[a-zA-Z0-9]{1,13}$","type":"string"},"state":{"description":"The current state of the space.","enum":["live","scheduled","ended"],"example":"live","type":"string"},"started_at":{"description":"When the space was started as a date string","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"is_ticketed":{"description":"Denotes if the space is a ticketed space","example":"false","type":"boolean"},"participant_count":{"description":"The number of participants in a space","example":10,"format":"int32","type":"integer"},"title":{"description":"The title of the space","example":"Spaces are Awesome","type":"string"},"host_ids":{"description":"The user ids for the hosts of the space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"updated_at":{"description":"When the space was last updated","example":"2021-7-14T04:35:55Z","format":"date-time","type":"string"},"created_at":{"description":"Creation time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"creator_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"lang":{"description":"The language of the space","example":"en","type":"string"},"speaker_ids":{"description":"An array of user ids for people who were speakers in a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"invited_user_ids":{"description":"An array of user ids for people who were invited to a space","items":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"type":"array"},"scheduled_start":{"description":"A date time stamp for when a space is scheduled to begin","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"ended_at":{"description":"End time of the space","example":"2021-07-06T18:40:40.000Z","format":"date-time","type":"string"},"topics":{"description":"The topics of a space, as selected by its creator","items":{"description":"The Twitter Topic object","type":"object","required":["id","name"],"properties":{"id":{"type":"string","description":"An ID suitable for use in the REST API."},"description":{"type":"string","description":"The description of the given topic."},"name":{"type":"string","description":"The name of the given topic."}},"example":{"id":"848920371311001600","description":"All about technology","name":"Technology"}},"type":"array"}}},"minItems":0},"includes":{"type":"object","properties":{"users":{"type":"array","items":{"description":"The Twitter User object","required":["id","name","username"],"properties":{"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"created_at":{"type":"string","format":"date-time","description":"Creation time of this user."},"name":{"type":"string","description":"The friendly name of this user, as shown on their profile."},"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"protected":{"type":"boolean","description":"Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private)."},"verified":{"type":"boolean","description":"Indicate if this user is a verified Twitter User."},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["country_codes"],"properties":{"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates that the content being withheld is a `user`.","enum":["user"]}}},"profile_image_url":{"type":"string","description":"The URL to the profile image for this user.","format":"uri"},"location":{"type":"string","description":"The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries."},"url":{"type":"string","description":"The URL specified in the user's profile."},"description":{"type":"string","description":"The text of this user's profile description (also known as bio), if the user provided one."},"entities":{"type":"object","description":"A list of metadata found in the user's profile description.","properties":{"url":{"type":"object","description":"Expanded details for the URL specified in the user's profile, with start and end indices.","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1}}},"description":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}}}},"pinned_tweet_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"public_metrics":{"type":"object","description":"A list of metrics for this user","required":["followers_count","following_count","tweet_count","listed_count"],"properties":{"followers_count":{"type":"integer","description":"Number of users who are following this user."},"following_count":{"type":"integer","description":"Number of users this user is following."},"tweet_count":{"type":"integer","description":"The number of Tweets (including Retweets) posted by this user."},"listed_count":{"type":"integer","description":"The number of lists that include this user."}}}},"example":{"id":"2244994945","created_at":"2013-12-14T04:35:55Z","name":"Twitter Dev","username":"TwitterDev","protected":false}},"minItems":1},"tweets":{"type":"array","items":{"type":"object","required":["id","text"],"properties":{"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"created_at":{"type":"string","format":"date-time","description":"Creation time of the Tweet.","example":"2021-01-06T18:40:40.000Z"},"text":{"type":"string","description":"The content of the Tweet.","example":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"},"author_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"in_reply_to_user_id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"},"conversation_id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"},"reply_settings":{"type":"string","pattern":"^[A-Za-z]{1,12}$","enum":["everyone","mentionedUsers","following","other"],"description":"Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following."},"referenced_tweets":{"type":"array","description":"A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.","items":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["retweeted","quoted","replied_to"]},"id":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}}},"minItems":1},"attachments":{"type":"object","description":"Specifies the type of attachments (if any) present in this Tweet.","properties":{"media_keys":{"type":"array","description":"A list of Media Keys for each one of the media attachments (if media are attached).","items":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"minItems":1},"poll_ids":{"type":"array","description":"A list of poll IDs (if polls are attached).","items":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"minItems":1}}},"context_annotations":{"type":"array","items":{"type":"object","description":"Annotation inferred from the tweet text.","required":["domain","entity"],"properties":{"domain":{"type":"object","description":"Represents the data for the context annotation domain.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation domain.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation domain."},"description":{"type":"string","description":"Description of the context annotation domain."}}},"entity":{"type":"object","description":"Represents the data for the context annotation entity.","required":["id"],"properties":{"id":{"type":"string","description":"The unique id for a context annotation entity.","pattern":"^[0-9]{1,19}$"},"name":{"type":"string","description":"Name of the context annotation entity."},"description":{"type":"string","description":"Description of the context annotation entity."}}}}},"minItems":1},"withheld":{"type":"object","description":"Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).","required":["copyright","country_codes"],"properties":{"copyright":{"type":"boolean","description":"Indicates if the content is being withheld for on the basis of copyright infringement."},"country_codes":{"type":"array","description":"Provides a list of countries where this content is not available.","items":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"uniqueItems":true,"minItems":1},"scope":{"type":"string","description":"Indicates whether the content being withheld is the `tweet` or a `user`.","enum":["tweet","user"]}}},"geo":{"type":"object","description":"The location tagged on the Tweet, if the user provided one.","properties":{"coordinates":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"place_id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"}}},"entities":{"type":"object","properties":{"urls":{"type":"array","items":{"description":"Represent the portion of text recognized as a URL, and its start and end position within the text.","allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a URL.","required":["url"],"properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"expanded_url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"display_url":{"type":"string","description":"The URL as displayed in the Twitter client.","example":"twittercommunity.com/t/introducing-…"},"unwound_url":{"type":"string","description":"Fully resolved url","format":"uri","example":"https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118"},"status":{"type":"integer","minimum":100,"maximum":599,"description":"HTTP Status Code."},"title":{"type":"string","description":"Title of the page the URL points to.","example":"Introducing the v2 follow lookup endpoints"},"description":{"type":"string","description":"Description of the URL landing page.","example":"This is a description of the website."},"images":{"type":"array","items":{"type":"object","description":"Represent the information for the URL image","properties":{"url":{"type":"string","description":"A validly formatted URL.","format":"uri","example":"https://developer.twitter.com/en/docs/twitter-api"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},"minItems":1}}}]},"minItems":1},"hashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Hashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","description":"The text of the Hashtag","example":"MondayMotivation"}}}]},"minItems":1},"mentions":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a User mention, and its start and end position within the text.","required":["username","id"],"properties":{"username":{"type":"string","description":"The Twitter handle (screen name) of this user.","pattern":"^[A-Za-z0-9_]{1,15}$"},"id":{"type":"string","description":"Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"2244994945"}}}]},"minItems":1},"cashtags":{"type":"array","items":{"allOf":[{"type":"object","description":"Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). `start` must be smaller than `end`.  The start index is inclusive, the end index is exclusive.","required":["start","end"],"properties":{"start":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity starts.  The index is inclusive.","example":50},"end":{"type":"integer","minimum":0,"description":"Index (zero-based) at which position this entity ends.  The index is exclusive.","example":61}}},{"type":"object","description":"Represent the portion of text recognized as a Cashtag, and its start and end position within the text.","required":["tag"],"properties":{"tag":{"type":"string","example":"TWTR"}}}]},"minItems":1}}},"public_metrics":{"type":"object","description":"Engagement metrics for the Tweet at the time of the request.","required":["retweet_count","reply_count","like_count"],"properties":{"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."},"quote_count":{"type":"integer","description":"Number of times this Tweet has been quoted."}}},"possibly_sensitive":{"type":"boolean","description":"Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.","example":false},"lang":{"type":"string","description":"Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.","example":"en"},"source":{"type":"string","description":"The name of the app the user Tweeted from."},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Tweet at the time of the request.","properties":{"impression_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been viewed."},"like_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been liked."},"reply_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been replied to."},"retweet_count":{"type":"integer","format":"int32","description":"Number of times this Tweet has been Retweeted."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Tweet at the time of the request.","required":["impression_count","retweet_count","reply_count","like_count"],"properties":{"impression_count":{"type":"integer","description":"Number of times this Tweet has been viewed."},"retweet_count":{"type":"integer","description":"Number of times this Tweet has been Retweeted."},"reply_count":{"type":"integer","description":"Number of times this Tweet has been replied to."},"like_count":{"type":"integer","description":"Number of times this Tweet has been liked."}}}},"example":{"id":"1346889436626259968","created_at":"Wed Jan 06 18:40:40 +0000 2021","text":"Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i","author_id":"2244994945"}},"minItems":1},"places":{"type":"array","items":{"required":["id","full_name"],"properties":{"id":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"name":{"type":"string","description":"The human readable name of this place.","example":"Lakewood"},"country_code":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter ISO 3166-1 alpha-2 country code","example":"US"},"place_type":{"type":"string","enum":["poi","neighborhood","city","admin","country","unknown"],"example":"city"},"full_name":{"type":"string","description":"The full name of this place.","example":"Lakewood, CO"},"country":{"type":"string","description":"The full name of the county in which this place exists.","example":"United States"},"contained_within":{"type":"array","items":{"type":"string","description":"The identifier for this place","example":"f7eb2fa2fea288b1"},"minItems":1},"geo":{"type":"object","required":["type","bbox","properties"],"properties":{"type":{"type":"string","enum":["Feature"]},"bbox":{"type":"array","maxItems":4,"minItems":4,"items":{"type":"number","format":"double","minimum":-180,"maximum":180},"example":[-105.193475,39.60973,-105.053164,39.761974]},"geometry":{"type":"object","description":"A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object.","required":["type","coordinates"],"properties":{"type":{"type":"string","enum":["Point"],"example":"Point"},"coordinates":{"type":"array","description":"A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.","items":{"type":"number"},"minItems":2,"maxItems":2,"example":[-105.18816086351444,40.247749999999996]}}},"properties":{"type":"object"}}}}},"minItems":1},"media":{"type":"array","items":{"type":"object","oneOf":[{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"url":{"type":"string","format":"uri"},"alt_text":{"type":"string"}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"preview_image_url":{"type":"string","format":"uri"},"duration_ms":{"type":"integer"},"public_metrics":{"type":"object","description":"Engagement metrics for the Media at the time of the request.","properties":{"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"non_public_metrics":{"type":"object","description":"Nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."}}},"organic_metrics":{"type":"object","description":"Organic nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}},"promoted_metrics":{"type":"object","description":"Promoted nonpublic engagement metrics for the Media at the time of the request.","properties":{"playback_0_count":{"type":"integer","format":"int32","description":"Number of users who made it through 0% of the video."},"playback_25_count":{"type":"integer","format":"int32","description":"Number of users who made it through 25% of the video."},"playback_50_count":{"type":"integer","format":"int32","description":"Number of users who made it through 50% of the video."},"playback_75_count":{"type":"integer","format":"int32","description":"Number of users who made it through 75% of the video."},"playback_100_count":{"type":"integer","format":"int32","description":"Number of users who made it through 100% of the video."},"view_count":{"type":"integer","format":"int32","description":"Number of times this video has been viewed."}}}}}]},{"type":"object","allOf":[{"properties":{"media_key":{"type":"string","description":"The Media Key identifier for this attachment.","pattern":"^([0-9]+)_([0-9]+)$"},"height":{"type":"integer","minimum":0,"description":"The height of the media in pixels"},"width":{"type":"integer","minimum":0,"description":"The width of the media in pixels"}}},{"type":"object","properties":{"type":{"type":"string","enum":["animated_gif"]},"preview_image_url":{"type":"string","format":"uri"}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"photo":"#/components/schemas/Photo","video":"#/components/schemas/Video","animated_gif":"#/components/schemas/AnimatedGif"}}},"minItems":1},"polls":{"type":"array","items":{"type":"object","description":"Represent a Poll attached to a Tweet","required":["id","options"],"properties":{"id":{"type":"string","description":"Unique identifier of this poll.","pattern":"^[0-9]{1,19}$","example":"1365059861688410112"},"options":{"type":"array","items":{"type":"object","description":"Describes a choice in a Poll object.","required":["position","label","votes"],"properties":{"position":{"type":"integer","description":"Position of this choice in the poll."},"label":{"type":"string","description":"The text of a poll choice."},"votes":{"type":"integer","description":"Number of users who voted for this choice."}}},"minItems":2,"maxItems":4},"voting_status":{"type":"string","enum":["open","closed"]},"end_datetime":{"type":"string","format":"date-time"},"duration_minutes":{"type":"integer"}}},"minItems":1}}},"errors":{"type":"array","items":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}},"minItems":1}}}},"responses":{"HttpErrorResponse":{"description":"The request has failed.","content":{"application/json":{"schema":{"required":["code","message"],"properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}},"application/problem+json":{"schema":{"description":"An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).","oneOf":[{"description":"A generic problem with no additional information beyond that provided by the HTTP status code.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["status"],"properties":{"type":{"type":"string","enum":["about:blank"]},"status":{"type":"integer"}}}]},{"description":"A problem that indicates this request is invalid.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-request"]},"errors":{"type":"array","items":{"type":"object","properties":{"parameters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"message":{"type":"string"}}}}}}]},{"description":"A problem that indicates your client is forbidden from making this request.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-forbidden"]},"reason":{"type":"string","enum":["official-client-forbidden","client-not-enrolled"]},"registration_url":{"type":"string","format":"uri"}}}]},{"description":"A problem that indicates that a given Tweet, User, etc. does not exist.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","value","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-not-found"]},"parameter":{"type":"string","minLength":1},"value":{"description":"Value will match the schema of the field."},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates a particular Tweet, User, etc. is not available to you.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"required":["parameter","resource_id","resource_type"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/resource-unavailable"]},"parameter":{"type":"string","minLength":1},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["user","tweet","media"]}}}]},{"description":"A problem that indicates you are not allowed to see a particular Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["value","resource_id","resource_type","section","parameter"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-resource"]},"value":{"type":"string"},"parameter":{"type":"string"},"section":{"type":"string","enum":["data","includes"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","user","media"]}}}]},{"description":"A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_type","field","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/not-authorized-for-field"]},"section":{"type":"string","enum":["data","includes"]},"resource_type":{"type":"string","enum":["tweet","media"]},"field":{"type":"string"}}}]},{"description":"A problem that indicates that the resource requested violates the precepts of this API.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","required":["resource_id","resource_type","section"],"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/disallowed-resource"]},"resource_id":{"type":"string"},"resource_type":{"type":"string","enum":["tweet","media"]},"section":{"type":"string","enum":["data","includes"]}}}]},{"description":"A problem that indicates that the authentication used is not supported.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/unsupported-authentication"]}}}]},{"description":"A problem that indicates that a usage cap has been exceeded.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/usage-capped"]},"period":{"type":"string","enum":["Daily","Monthly"]},"scope":{"type":"string","enum":["Account","Product"]}}}]},{"description":"A problem that indicates something is wrong with the connection","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/streaming-connection"]},"connection_issue":{"type":"string","enum":["TooManyConnections","ProvisioningSubscription","RuleConfigurationIssue","RulesInvalidIssue"]}}}]},{"description":"Your client has gone away.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/client-disconnected"]}}}]},{"description":"You have been disconnected for operational reasons.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/operational-disconnect"]},"disconnect_type":{"type":"string","enum":["OperationalDisconnect","UpstreamOperationalDisconnect","ForceDisconnect","UpstreamUncleanDisconnect","SlowReader","InternalError","ClientApplicationStateDegraded","InvalidRules"]}}}]},{"description":"You have exceeded the maximum number of rules.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/rule-cap"]}}}]},{"description":"The rule you have submitted is invalid.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/invalid-rules"]}}}]},{"description":"The rule you have submitted is a duplicate.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/duplicate-rules"]}}}]},{"description":"You cannot create a new job if one is already in progress.","type":"object","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/conflict"]}}}]},{"description":"A problem that indicates the user's rule set is not compliant.","allOf":[{"type":"object","required":["title","detail"],"properties":{"title":{"type":"string"},"detail":{"type":"string"}}},{"type":"object","properties":{"type":{"type":"string","enum":["https://api.twitter.com/2/problems/noncompliant-rules"]}}}]}],"properties":{"type":{"type":"string"}},"required":["type"],"discriminator":{"propertyName":"type","mapping":{"about:blank":"#/components/schemas/GenericProblem","https://api.twitter.com/2/problems/invalid-request":"#/components/schemas/InvalidRequestProblem","https://api.twitter.com/2/problems/client-forbidden":"#/components/schemas/ClientForbiddenProblem","https://api.twitter.com/2/problems/resource-not-found":"#/components/schemas/ResourceNotFoundProblem","https://api.twitter.com/2/problems/resource-unavailable":"#/components/schemas/ResourceUnavailableProblem","https://api.twitter.com/2/problems/not-authorized-for-resource":"#/components/schemas/ResourceUnauthorizedProblem","https://api.twitter.com/2/problems/not-authorized-for-field":"#/components/schemas/FieldUnauthorizedProblem","https://api.twitter.com/2/problems/disallowed-resource":"#/components/schemas/DisallowedResourceProblem","https://api.twitter.com/2/problems/unsupported-authentication":"#/components/schemas/UnsupportedAuthenticationProblem","https://api.twitter.com/2/problems/usage-capped":"#/components/schemas/UsageCapExceededProblem","https://api.twitter.com/2/problems/streaming-connection":"#/components/schemas/ConnectionExceptionProblem","https://api.twitter.com/2/problems/client-disconnected":"#/components/schemas/ClientDisconnectedProblem","https://api.twitter.com/2/problems/operational-disconnect":"#/components/schemas/OperationalDisconnectProblem","https://api.twitter.com/2/problems/rule-cap":"#/components/schemas/RulesCapProblem","https://api.twitter.com/2/problems/invalid-rules":"#/components/schemas/InvalidRuleProblem","https://api.twitter.com/2/problems/duplicate-rules":"#/components/schemas/DuplicateRuleProblem","https://api.twitter.com/2/problems/conflict":"#/components/schemas/ConflictProblem","https://api.twitter.com/2/problems/noncompliant-rules":"#/components/schemas/NonCompliantRulesProblem"}}}}}}},"parameters":{"TweetExpansionsParameter":{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]},"minItems":1,"uniqueItems":true,"example":["author_id","referenced_tweets.id","in_reply_to_user_id","geo.place_id","attachments.media_keys","attachments.poll_ids","entities.mentions.username","referenced_tweets.id.author_id"]}},"SpaceFieldsParameter":{"name":"space.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Space fields to display.","schema":{"description":"The fields available for a Space object.","type":"array","items":{"type":"string","enum":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]},"minItems":1,"uniqueItems":true,"example":["created_at","creator_id","host_ids","invited_user_ids","is_ticketed","lang","participant_count","scheduled_start","speaker_ids","started_at","title","updated_at"]}},"UserExpansionsParameter":{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [User](#User) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["pinned_tweet_id"]},"minItems":1,"uniqueItems":true,"example":["pinned_tweet_id"]}},"SpaceExpansionsParameter":{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [Space](#Space) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["creator_id","host_ids","invited_user_ids","speaker_ids"]},"minItems":1,"uniqueItems":true,"example":["creator_id","host_ids","invited_user_ids","speaker_ids"]}},"ListExpansionsParameter":{"name":"expansions","in":"query","style":"form","explode":false,"description":"A comma separated list of fields to expand.","schema":{"description":"The list of fields you can expand for a [List](#List) object. If the field has an ID, it can be expanded into a full object.","type":"array","items":{"type":"string","enum":["owner_id"]},"minItems":1,"uniqueItems":true,"example":["owner_id"]}},"TweetFieldsParameter":{"name":"tweet.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Tweet fields to display.","schema":{"description":"The list of fields you can display for a [Tweet](#Tweet) object.","type":"array","items":{"type":"string","enum":["id","created_at","text","author_id","in_reply_to_user_id","referenced_tweets","attachments","withheld","geo","entities","public_metrics","possibly_sensitive","source","lang","context_annotations","non_public_metrics","promoted_metrics","organic_metrics","conversation_id","reply_settings"]},"minItems":1,"uniqueItems":true,"example":["created_at","author_id","entities","conversation_id","reply_settings","public_metrics"]}},"UserFieldsParameter":{"name":"user.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of User fields to display.","schema":{"description":"The list of fields you can display for a [User](#User) object.","type":"array","items":{"type":"string","enum":["id","created_at","name","username","protected","verified","withheld","profile_image_url","location","url","description","entities","pinned_tweet_id","public_metrics"]},"minItems":1,"uniqueItems":true,"example":["username","verified","profile_image_url"]}},"MediaFieldsParameter":{"name":"media.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Media fields to display.","schema":{"description":"The list of fields you can display for a Media object.","type":"array","items":{"type":"string","enum":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics","non_public_metrics","organic_metrics","promoted_metrics","alt_text"]},"minItems":1,"example":["media_key","duration_ms","height","preview_image_url","type","url","width","public_metrics"],"uniqueItems":true}},"PlaceFieldsParameter":{"name":"place.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Place fields to display.","schema":{"description":"The list of fields you can display for a Place object.","type":"array","items":{"type":"string","enum":["id","name","country_code","place_type","full_name","country","contained_within","geo"]},"minItems":1,"uniqueItems":true,"example":["id","name","country_code","place_type","full_name","country","contained_within","geo"]}},"PollFieldsParameter":{"name":"poll.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of Poll fields to display.","schema":{"description":"The list of fields you can display for a Poll object.","type":"array","items":{"type":"string","enum":["id","options","voting_status","end_datetime","duration_minutes"]},"minItems":1,"uniqueItems":true,"example":["duration_minutes","options","voting_status","end_datetime"]}},"ListFieldsParameter":{"name":"list.fields","in":"query","style":"form","explode":false,"required":false,"description":"A comma separated list of List fields to display.","schema":{"description":"The fields available for a List object.","type":"array","items":{"type":"string","enum":["created_at","description","follower_count","id","member_count","name","owner_id","private"]},"minItems":1,"uniqueItems":true,"example":["created_at","description","follower_count","member_count","name","private"]}},"SinceIdRequestParameter":{"name":"since_id","in":"query","description":"The minimum Tweet ID to be included in the result set. This parameter takes precedence over start_time if both are specified.","required":false,"example":"791775337160081409","schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},"UntilIdRequestParameter":{"name":"until_id","in":"query","description":"The maximum Tweet ID to be included in the result set. This parameter takes precedence over end_time if both are specified.","required":false,"example":"1346889436626259968","schema":{"type":"string","description":"Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.","pattern":"^[0-9]{1,19}$","example":"1346889436626259968"}},"PaginationTokenRequestParameter":{"name":"pagination_token","in":"query","description":"This parameter is used to get the next 'page' of results.","required":false,"schema":{"type":"string","minLength":1}},"SignedLongPaginationTokenRequestParameter":{"name":"pagination_token","in":"query","description":"This parameter is used to get a specified 'page' of results.","required":false,"schema":{"type":"integer","format":"int64"}},"MaxResultsRequestParameter":{"name":"max_results","in":"query","description":"The maximum number of results","required":false,"schema":{"type":"integer","format":"int32","minimum":5,"maximum":100}},"StartTimeRequestParameter":{"name":"start_time","in":"query","description":"YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Tweets will be provided. The since_id parameter takes precedence if it is also specified.","required":false,"example":"2021-02-01T18:40:40.000Z","schema":{"type":"string","format":"date-time"}},"EndTimeRequestParameter":{"name":"end_time","in":"query","description":"YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Tweets will be provided. The until_id parameter takes precedence if it is also specified.","required":false,"example":"2021-02-14T18:40:40.000Z","schema":{"type":"string","format":"date-time"}},"TweetTypeExcludesRequestParameter":{"name":"exclude","in":"query","style":"form","explode":false,"description":"The set of entities to exclude (e.g. 'replies' or 'retweets')","required":false,"schema":{"description":"The set of entities to exclude (e.g. 'replies' or 'retweets')","type":"array","items":{"type":"string","enum":["replies","retweets"]},"minItems":1,"uniqueItems":true,"example":["replies","retweets"]}},"BackfillMinutesRequestParameter":{"name":"backfill_minutes","in":"query","description":"The number of minutes of backfill requested","required":false,"schema":{"type":"integer","format":"int32","minimum":0,"maximum":5}}}}}