Retrieve tweets from a Space

GET /2/spaces/{id}/tweets

Retrieves tweets shared in the specified space

Path parameters

  • id string Required

    The space id from which tweets will be retrieved

Query parameters

  • max_results integer(int32)

    The number of tweets to fetch from the provided space. If not provided, the value will default to the maximum of 100

    Minimum value is 1, maximum value is 100.

  • tweet.fields array[string]

    A comma separated list of Tweet fields to display.

Responses

  • 200

    The request was successful

    Hide response attributes Show response attributes object
    • data array[object]
      Hide data attributes Show data attributes array[object]
      • id string Required

        Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

        Format should match the following pattern: ^[0-9]{1,19}$.

      • created_at string(date-time)

        Creation time of the Tweet.

      • text string Required

        The content of the Tweet.

      • author_id string

        Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

        Format should match the following pattern: ^[0-9]{1,19}$.

      • in_reply_to_user_id string

        Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

        Format should match the following pattern: ^[0-9]{1,19}$.

      • conversation_id string

        Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

        Format should match the following pattern: ^[0-9]{1,19}$.

      • reply_settings string

        Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following.

        Format should match the following pattern: ^[A-Za-z]{1,12}$. Values are everyone, mentionedUsers, following, or other.

      • referenced_tweets array[object]

        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.

        At least 1 element.

        Hide referenced_tweets attributes Show referenced_tweets attributes array[object]
        • type string Required

          Values are retweeted, quoted, or replied_to.

        • id string Required

          Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

          Format should match the following pattern: ^[0-9]{1,19}$.

      • attachments object

        Specifies the type of attachments (if any) present in this Tweet.

        Hide attachments attributes Show attachments attributes object
        • media_keys array[string]

          The Media Key identifier for this attachment.

          At least 1 element. Format of each should match the following pattern: ^([0-9]+)_([0-9]+)$.

        • poll_ids array[string]

          Unique identifier of this poll.

          At least 1 element. Format of each should match the following pattern: ^[0-9]{1,19}$.

      • context_annotations array[object]

        Annotation inferred from the tweet text.

        At least 1 element.

        Hide context_annotations attributes Show context_annotations attributes array[object]
        • domain object Required

          Represents the data for the context annotation domain.

          Hide domain attributes Show domain attributes object
          • id string Required

            The unique id for a context annotation domain.

            Format should match the following pattern: ^[0-9]{1,19}$.

          • name string

            Name of the context annotation domain.

          • description string

            Description of the context annotation domain.

        • entity object Required

          Represents the data for the context annotation entity.

          Hide entity attributes Show entity attributes object
          • id string Required

            The unique id for a context annotation entity.

            Format should match the following pattern: ^[0-9]{1,19}$.

          • name string

            Name of the context annotation entity.

          • description string

            Description of the context annotation entity.

      • withheld object

        Indicates withholding details for withheld content.

        Hide withheld attributes Show withheld attributes object
        • country_codes array[string] Required

          A two-letter ISO 3166-1 alpha-2 country code

          At least 1 element. Format of each should match the following pattern: ^[A-Z]{2}$.

        • scope string

          Indicates whether the content being withheld is the tweet or a user.

          Values are tweet or user.

      • geo object

        The location tagged on the Tweet, if the user provided one.

        Hide geo attributes Show geo attributes object
        • coordinates object

          A GeoJson Point geometry object.

          Hide coordinates attributes Show coordinates attributes object
          • type string Required

            Value is Point.

          • coordinates array[number] Required

            A GeoJson Position in the format [longitude,latitude].

            At least 2 but not more than 2 elements.

        • place_id string

          The identifier for this place

      • entities object
        Hide entities attributes Show entities attributes object
        • urls array[object]

          Represent the portion of text recognized as a URL.

          At least 1 element.

          Hide urls attributes Show urls attributes array[object]
          • start integer Required

            Index (zero-based) at which position this entity starts. The index is inclusive.

            Minimum value is 0.

          • end integer Required

            Index (zero-based) at which position this entity ends. The index is exclusive.

            Minimum value is 0.

          • url string(uri) Required

            A validly formatted URL.

          • expanded_url string(uri)

            A validly formatted URL.

          • display_url string

            The URL as displayed in the Twitter client.

          • unwound_url string(uri)

            Fully resolved url

          • status integer

            HTTP Status Code.

            Minimum value is 100, maximum value is 599.

          • title string

            Title of the page the URL points to.

          • description string

            Description of the URL landing page.

          • images array[object]

            Represent the information for the URL image

            At least 1 element.

            Hide images attributes Show images attributes array[object]
            • url string(uri)

              A validly formatted URL.

            • height integer

              The height of the media in pixels

              Minimum value is 0.

            • width integer

              The width of the media in pixels

              Minimum value is 0.

        • hashtags array[object]

          Represent the portion of text recognized as a Hashtag, and its start and end position within the text.

          At least 1 element.

          Hide hashtags attributes Show hashtags attributes array[object]
          • start integer Required

            Index (zero-based) at which position this entity starts. The index is inclusive.

            Minimum value is 0.

          • end integer Required

            Index (zero-based) at which position this entity ends. The index is exclusive.

            Minimum value is 0.

          • tag string Required

            The text of the Hashtag

        • mentions array[object]

          Represent the portion of text recognized as a User mention, and its start and end position within the text.

          At least 1 element.

          Hide mentions attributes Show mentions attributes array[object]
          • start integer Required

            Index (zero-based) at which position this entity starts. The index is inclusive.

            Minimum value is 0.

          • end integer Required

            Index (zero-based) at which position this entity ends. The index is exclusive.

            Minimum value is 0.

          • username string Required

            The Twitter handle (screen name) of this user.

            Format should match the following pattern: ^[A-Za-z0-9_]{1,15}$.

          • id string Required

            Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

            Format should match the following pattern: ^[0-9]{1,19}$.

        • cashtags array[object]

          Represent the portion of text recognized as a Cashtag, and its start and end position within the text.

          At least 1 element.

          Hide cashtags attributes Show cashtags attributes array[object]
          • start integer Required

            Index (zero-based) at which position this entity starts. The index is inclusive.

            Minimum value is 0.

          • end integer Required

            Index (zero-based) at which position this entity ends. The index is exclusive.

            Minimum value is 0.

          • tag string Required
      • public_metrics object

        Engagement metrics for the Tweet at the time of the request.

        Hide public_metrics attributes Show public_metrics attributes object
        • retweet_count integer Required

          Number of times this Tweet has been Retweeted.

        • reply_count integer Required

          Number of times this Tweet has been replied to.

        • like_count integer Required

          Number of times this Tweet has been liked.

        • quote_count integer

          Number of times this Tweet has been quoted.

      • possibly_sensitive boolean

        Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.

      • lang string

        Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.

      • source string

        The name of the app the user Tweeted from.

      • non_public_metrics object

        Nonpublic engagement metrics for the Tweet at the time of the request.

        Hide non_public_metrics attribute Show non_public_metrics attribute object
        • impression_count integer(int32)

          Number of times this Tweet has been viewed.

      • promoted_metrics object

        Promoted nonpublic engagement metrics for the Tweet at the time of the request.

        Hide promoted_metrics attributes Show promoted_metrics attributes object
        • impression_count integer(int32)

          Number of times this Tweet has been viewed.

        • like_count integer(int32)

          Number of times this Tweet has been liked.

        • reply_count integer(int32)

          Number of times this Tweet has been replied to.

        • retweet_count integer(int32)

          Number of times this Tweet has been Retweeted.

      • organic_metrics object

        Organic nonpublic engagement metrics for the Tweet at the time of the request.

        Hide organic_metrics attributes Show organic_metrics attributes object
        • impression_count integer Required

          Number of times this Tweet has been viewed.

        • retweet_count integer Required

          Number of times this Tweet has been Retweeted.

        • reply_count integer Required

          Number of times this Tweet has been replied to.

        • like_count integer Required

          Number of times this Tweet has been liked.

    • includes object
      Hide includes attributes Show includes attributes object
      • users array[object]

        The Twitter User object

        At least 1 element.

        Hide users attributes Show users attributes array[object]
        • id string Required

          Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

          Format should match the following pattern: ^[0-9]{1,19}$.

        • created_at string(date-time)

          Creation time of this user.

        • name string Required

          The friendly name of this user, as shown on their profile.

        • username string Required

          The Twitter handle (screen name) of this user.

          Format should match the following pattern: ^[A-Za-z0-9_]{1,15}$.

        • protected boolean

          Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private).

        • verified boolean

          Indicate if this user is a verified Twitter User.

        • withheld object

          Indicates withholding details for withheld content.

          Hide withheld attributes Show withheld attributes object
          • country_codes array[string] Required

            A two-letter ISO 3166-1 alpha-2 country code

            At least 1 element. Format of each should match the following pattern: ^[A-Z]{2}$.

          • scope string

            Indicates that the content being withheld is a user.

            Value is user.

        • profile_image_url string(uri)

          The URL to the profile image for this user.

        • location string

          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 string

          The URL specified in the user's profile.

        • description string

          The text of this user's profile description (also known as bio), if the user provided one.

        • entities object

          A list of metadata found in the user's profile description.

          Hide entities attributes Show entities attributes object
          • url object

            Expanded details for the URL specified in the user's profile, with start and end indices.

            Hide url attribute Show url attribute object
            • urls array[object]

              Represent the portion of text recognized as a URL.

              At least 1 element.

              Hide urls attributes Show urls attributes array[object]
              • start integer Required

                Index (zero-based) at which position this entity starts. The index is inclusive.

                Minimum value is 0.

              • end integer Required

                Index (zero-based) at which position this entity ends. The index is exclusive.

                Minimum value is 0.

              • url string(uri) Required

                A validly formatted URL.

              • expanded_url string(uri)

                A validly formatted URL.

              • display_url string

                The URL as displayed in the Twitter client.

              • unwound_url string(uri)

                Fully resolved url

              • status integer

                HTTP Status Code.

                Minimum value is 100, maximum value is 599.

              • title string

                Title of the page the URL points to.

              • description string

                Description of the URL landing page.

              • images array[object]

                Represent the information for the URL image

                At least 1 element.

                Hide images attributes Show images attributes array[object]
                • url string(uri)

                  A validly formatted URL.

                • height integer

                  The height of the media in pixels

                  Minimum value is 0.

                • width integer

                  The width of the media in pixels

                  Minimum value is 0.

          • description object
            Hide description attributes Show description attributes object
            • urls array[object]

              Represent the portion of text recognized as a URL.

              At least 1 element.

              Hide urls attributes Show urls attributes array[object]
              • start integer Required

                Index (zero-based) at which position this entity starts. The index is inclusive.

                Minimum value is 0.

              • end integer Required

                Index (zero-based) at which position this entity ends. The index is exclusive.

                Minimum value is 0.

              • url string(uri) Required

                A validly formatted URL.

              • expanded_url string(uri)

                A validly formatted URL.

              • display_url string

                The URL as displayed in the Twitter client.

              • unwound_url string(uri)

                Fully resolved url

              • status integer

                HTTP Status Code.

                Minimum value is 100, maximum value is 599.

              • title string

                Title of the page the URL points to.

              • description string

                Description of the URL landing page.

              • images array[object]

                Represent the information for the URL image

                At least 1 element.

                Hide images attributes Show images attributes array[object]
                • url string(uri)

                  A validly formatted URL.

                • height integer

                  The height of the media in pixels

                  Minimum value is 0.

                • width integer

                  The width of the media in pixels

                  Minimum value is 0.

            • hashtags array[object]

              Represent the portion of text recognized as a Hashtag, and its start and end position within the text.

              At least 1 element.

              Hide hashtags attributes Show hashtags attributes array[object]
              • start integer Required

                Index (zero-based) at which position this entity starts. The index is inclusive.

                Minimum value is 0.

              • end integer Required

                Index (zero-based) at which position this entity ends. The index is exclusive.

                Minimum value is 0.

              • tag string Required

                The text of the Hashtag

            • mentions array[object]

              Represent the portion of text recognized as a User mention, and its start and end position within the text.

              At least 1 element.

              Hide mentions attributes Show mentions attributes array[object]
              • start integer Required

                Index (zero-based) at which position this entity starts. The index is inclusive.

                Minimum value is 0.

              • end integer Required

                Index (zero-based) at which position this entity ends. The index is exclusive.

                Minimum value is 0.

              • username string Required

                The Twitter handle (screen name) of this user.

                Format should match the following pattern: ^[A-Za-z0-9_]{1,15}$.

              • id string Required

                Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

                Format should match the following pattern: ^[0-9]{1,19}$.

            • cashtags array[object]

              Represent the portion of text recognized as a Cashtag, and its start and end position within the text.

              At least 1 element.

              Hide cashtags attributes Show cashtags attributes array[object]
              • end integer Required

                Index (zero-based) at which position this entity ends. The index is exclusive.

                Minimum value is 0.

              • start integer Required

                Index (zero-based) at which position this entity starts. The index is inclusive.

                Minimum value is 0.

              • tag string Required
        • pinned_tweet_id string

          Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

          Format should match the following pattern: ^[0-9]{1,19}$.

        • public_metrics object

          A list of metrics for this user

          Hide public_metrics attributes Show public_metrics attributes object
          • tweet_count integer Required

            The number of Tweets (including Retweets) posted by this user.

          • followers_count integer Required

            Number of users who are following this user.

          • following_count integer Required

            Number of users this user is following.

          • listed_count integer Required

            The number of lists that include this user.

      • tweets array[object]

        At least 1 element.

        Hide tweets attributes Show tweets attributes array[object]
        • id string Required

          Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

          Format should match the following pattern: ^[0-9]{1,19}$.

        • created_at string(date-time)

          Creation time of the Tweet.

        • text string Required

          The content of the Tweet.

        • author_id string

          Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

          Format should match the following pattern: ^[0-9]{1,19}$.

        • in_reply_to_user_id string

          Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

          Format should match the following pattern: ^[0-9]{1,19}$.

        • conversation_id string

          Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

          Format should match the following pattern: ^[0-9]{1,19}$.

        • reply_settings string

          Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following.

          Format should match the following pattern: ^[A-Za-z]{1,12}$. Values are everyone, mentionedUsers, following, or other.

        • referenced_tweets array[object]

          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.

          At least 1 element.

          Hide referenced_tweets attributes Show referenced_tweets attributes array[object]
          • type string Required

            Values are retweeted, quoted, or replied_to.

          • id string Required

            Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

            Format should match the following pattern: ^[0-9]{1,19}$.

        • attachments object

          Specifies the type of attachments (if any) present in this Tweet.

          Hide attachments attributes Show attachments attributes object
          • media_keys array[string]

            The Media Key identifier for this attachment.

            At least 1 element. Format of each should match the following pattern: ^([0-9]+)_([0-9]+)$.

          • poll_ids array[string]

            Unique identifier of this poll.

            At least 1 element. Format of each should match the following pattern: ^[0-9]{1,19}$.

        • context_annotations array[object]

          Annotation inferred from the tweet text.

          At least 1 element.

          Hide context_annotations attributes Show context_annotations attributes array[object]
          • domain object Required

            Represents the data for the context annotation domain.

            Hide domain attributes Show domain attributes object
            • id string Required

              The unique id for a context annotation domain.

              Format should match the following pattern: ^[0-9]{1,19}$.

            • name string

              Name of the context annotation domain.

            • description string

              Description of the context annotation domain.

          • entity object Required

            Represents the data for the context annotation entity.

            Hide entity attributes Show entity attributes object
            • id string Required

              The unique id for a context annotation entity.

              Format should match the following pattern: ^[0-9]{1,19}$.

            • name string

              Name of the context annotation entity.

            • description string

              Description of the context annotation entity.

        • withheld object

          Indicates withholding details for withheld content.

          Hide withheld attributes Show withheld attributes object
          • country_codes array[string] Required

            A two-letter ISO 3166-1 alpha-2 country code

            At least 1 element. Format of each should match the following pattern: ^[A-Z]{2}$.

          • scope string

            Indicates whether the content being withheld is the tweet or a user.

            Values are tweet or user.

        • geo object

          The location tagged on the Tweet, if the user provided one.

          Hide geo attributes Show geo attributes object
          • coordinates object

            A GeoJson Point geometry object.

            Hide coordinates attributes Show coordinates attributes object
            • type string Required

              Value is Point.

            • coordinates array[number] Required

              A GeoJson Position in the format [longitude,latitude].

              At least 2 but not more than 2 elements.

          • place_id string

            The identifier for this place

        • entities object
          Hide entities attributes Show entities attributes object
          • urls array[object]

            Represent the portion of text recognized as a URL.

            At least 1 element.

            Hide urls attributes Show urls attributes array[object]
            • start integer Required

              Index (zero-based) at which position this entity starts. The index is inclusive.

              Minimum value is 0.

            • end integer Required

              Index (zero-based) at which position this entity ends. The index is exclusive.

              Minimum value is 0.

            • url string(uri) Required

              A validly formatted URL.

            • expanded_url string(uri)

              A validly formatted URL.

            • display_url string

              The URL as displayed in the Twitter client.

            • unwound_url string(uri)

              Fully resolved url

            • status integer

              HTTP Status Code.

              Minimum value is 100, maximum value is 599.

            • title string

              Title of the page the URL points to.

            • description string

              Description of the URL landing page.

            • images array[object]

              Represent the information for the URL image

              At least 1 element.

              Hide images attributes Show images attributes array[object]
              • url string(uri)

                A validly formatted URL.

              • height integer

                The height of the media in pixels

                Minimum value is 0.

              • width integer

                The width of the media in pixels

                Minimum value is 0.

          • hashtags array[object]

            Represent the portion of text recognized as a Hashtag, and its start and end position within the text.

            At least 1 element.

            Hide hashtags attributes Show hashtags attributes array[object]
            • start integer Required

              Index (zero-based) at which position this entity starts. The index is inclusive.

              Minimum value is 0.

            • end integer Required

              Index (zero-based) at which position this entity ends. The index is exclusive.

              Minimum value is 0.

            • tag string Required

              The text of the Hashtag

          • mentions array[object]

            Represent the portion of text recognized as a User mention, and its start and end position within the text.

            At least 1 element.

            Hide mentions attributes Show mentions attributes array[object]
            • start integer Required

              Index (zero-based) at which position this entity starts. The index is inclusive.

              Minimum value is 0.

            • end integer Required

              Index (zero-based) at which position this entity ends. The index is exclusive.

              Minimum value is 0.

            • username string Required

              The Twitter handle (screen name) of this user.

              Format should match the following pattern: ^[A-Za-z0-9_]{1,15}$.

            • id string Required

              Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

              Format should match the following pattern: ^[0-9]{1,19}$.

          • cashtags array[object]

            Represent the portion of text recognized as a Cashtag, and its start and end position within the text.

            At least 1 element.

            Hide cashtags attributes Show cashtags attributes array[object]
            • start integer Required

              Index (zero-based) at which position this entity starts. The index is inclusive.

              Minimum value is 0.

            • end integer Required

              Index (zero-based) at which position this entity ends. The index is exclusive.

              Minimum value is 0.

            • tag string Required
        • public_metrics object

          Engagement metrics for the Tweet at the time of the request.

          Hide public_metrics attributes Show public_metrics attributes object
          • retweet_count integer Required

            Number of times this Tweet has been Retweeted.

          • reply_count integer Required

            Number of times this Tweet has been replied to.

          • like_count integer Required

            Number of times this Tweet has been liked.

          • quote_count integer

            Number of times this Tweet has been quoted.

        • possibly_sensitive boolean

          Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.

        • lang string

          Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.

        • source string

          The name of the app the user Tweeted from.

        • non_public_metrics object

          Nonpublic engagement metrics for the Tweet at the time of the request.

          Hide non_public_metrics attribute Show non_public_metrics attribute object
          • impression_count integer(int32)

            Number of times this Tweet has been viewed.

        • promoted_metrics object

          Promoted nonpublic engagement metrics for the Tweet at the time of the request.

          Hide promoted_metrics attributes Show promoted_metrics attributes object
          • impression_count integer(int32)

            Number of times this Tweet has been viewed.

          • like_count integer(int32)

            Number of times this Tweet has been liked.

          • reply_count integer(int32)

            Number of times this Tweet has been replied to.

          • retweet_count integer(int32)

            Number of times this Tweet has been Retweeted.

        • organic_metrics object

          Organic nonpublic engagement metrics for the Tweet at the time of the request.

          Hide organic_metrics attributes Show organic_metrics attributes object
          • impression_count integer Required

            Number of times this Tweet has been viewed.

          • retweet_count integer Required

            Number of times this Tweet has been Retweeted.

          • reply_count integer Required

            Number of times this Tweet has been replied to.

          • like_count integer Required

            Number of times this Tweet has been liked.

      • places array[object]

        At least 1 element.

        Hide places attributes Show places attributes array[object]
        • id string Required

          The identifier for this place

        • name string

          The human readable name of this place.

        • country_code string

          A two-letter ISO 3166-1 alpha-2 country code

          Format should match the following pattern: ^[A-Z]{2}$.

        • place_type string

          Values are poi, neighborhood, city, admin, country, or unknown.

        • full_name string Required

          The full name of this place.

        • country string

          The full name of the county in which this place exists.

        • contained_within array[string]

          The identifier for this place

          At least 1 element.

        • geo object
          Hide geo attributes Show geo attributes object
          • type string Required

            Value is Feature.

          • bbox array[number(double)] Required

            At least 4 but not more than 4 elements. Minimum value of each is -180, maximum value of each is 180.

          • geometry object

            A GeoJson Point geometry object.

            Hide geometry attributes Show geometry attributes object
            • type string Required

              Value is Point.

            • coordinates array[number] Required

              A GeoJson Position in the format [longitude,latitude].

              At least 2 but not more than 2 elements.

          • properties object Required
      • media array[object]

        At least 1 element.

        Hide media attributes Show media attributes array[object]
        • type string Required
        • media_key string

          The Media Key identifier for this attachment.

          Format should match the following pattern: ^([0-9]+)_([0-9]+)$.

        • height integer

          The height of the media in pixels

          Minimum value is 0.

        • width integer

          The width of the media in pixels

          Minimum value is 0.

      • polls array[object]

        Represent a Poll attached to a Tweet

        At least 1 element.

        Hide polls attributes Show polls attributes array[object]
        • id string Required

          Unique identifier of this poll.

          Format should match the following pattern: ^[0-9]{1,19}$.

        • options array[object] Required

          Describes a choice in a Poll object.

          At least 2 but not more than 4 elements.

          Hide options attributes Show options attributes array[object]
          • position integer Required

            Position of this choice in the poll.

          • label string Required

            The text of a poll choice.

            Minimum length is 1, maximum length is 25.

          • votes integer Required

            Number of users who voted for this choice.

        • voting_status string

          Values are open or closed.

        • end_datetime string(date-time)
        • duration_minutes integer
    • meta object
      Hide meta attribute Show meta attribute object
      • result_count integer

        The number of spaces results returned in this response

    • errors array[object]

      An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).

      At least 1 element.

      Hide errors attributes Show errors attributes array[object]
      • type string Required
      • title string Required
      • detail string
      • status integer
  • default

    The request has failed.

    Hide response attributes Show response attributes object
    • code integer(int32) Required
    • message string Required
GET /2/spaces/{id}/tweets
curl \
 -X GET https://api.twitter.com/2/spaces/1YqKDqWqdPLsV/tweets \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "data": [
    {
      "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": {
    "users": [
      {
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55Z",
        "name": "Twitter Dev",
        "username": "TwitterDev",
        "protected": false
      }
    ],
    "tweets": [
      {
        "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"
      }
    ],
    "places": [
      {
        "id": "f7eb2fa2fea288b1",
        "name": "Lakewood",
        "country_code": "US",
        "place_type": "city",
        "full_name": "Lakewood, CO",
        "country": "United States",
        "contained_within": [
          "f7eb2fa2fea288b1"
        ],
        "geo": {
          "type": "Feature",
          "bbox": [
            -105.193475,
            39.60973,
            -105.053164,
            39.761974
          ],
          "geometry": {
            "type": "Point",
            "coordinates": [
              "-105.18816086351444",
              "40.247749999999996"
            ]
          },
          "properties": {}
        }
      }
    ],
    "media": [
      {
        "type": "string",
        "media_key": "string",
        "height": 42,
        "width": 42
      }
    ],
    "polls": [
      {
        "id": "1365059861688410112",
        "options": [
          {
            "position": 42,
            "label": "string",
            "votes": 42
          }
        ],
        "voting_status": "open",
        "end_datetime": "2023-05-04T09:42:00+00:00",
        "duration_minutes": 42
      }
    ]
  },
  "meta": {
    "result_count": 42
  },
  "errors": [
    {
      "type": "string",
      "title": "string",
      "detail": "string",
      "status": 42
    }
  ]
}
Response examples (200)
{
  "data": [
    {
      "id": "1346889436626259968",
      "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",
      "created_at": "Wed Jan 06 18:40:40 +0000 2021"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "name": "Twitter Dev",
        "username": "TwitterDev",
        "protected": false,
        "created_at": "2013-12-14T04:35:55Z"
      }
    ],
    "tweets": [
      {
        "id": "1346889436626259968",
        "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",
        "created_at": "Wed Jan 06 18:40:40 +0000 2021"
      }
    ],
    "places": [
      {
        "id": "f7eb2fa2fea288b1",
        "name": "Lakewood",
        "country_code": "US",
        "place_type": "city",
        "full_name": "Lakewood, CO",
        "country": "United States",
        "contained_within": [
          "f7eb2fa2fea288b1"
        ],
        "geo": {
          "type": "Feature",
          "bbox": [
            -105.193475,
            39.60973,
            -105.053164,
            39.761974
          ],
          "geometry": {
            "type": "Point",
            "coordinates": [
              "-105.18816086351444",
              "40.247749999999996"
            ]
          },
          "properties": {}
        }
      }
    ],
    "media": [
      {
        "type": "string",
        "media_key": "string",
        "height": 42,
        "width": 42
      }
    ],
    "polls": [
      {
        "id": "1365059861688410112",
        "options": [
          {
            "position": 42,
            "label": "string",
            "votes": 42
          }
        ],
        "voting_status": "open",
        "end_datetime": "2025-05-04T09:42:00Z",
        "duration_minutes": 42
      }
    ]
  },
  "meta": {
    "result_count": 42
  },
  "errors": [
    {
      "type": "string",
      "title": "string",
      "detail": "string",
      "status": 42
    }
  ]
}
Response examples (default)
{
  "code": 42,
  "message": "string"
}
Response examples (default)
{
  "code": 42,
  "message": "string"
}