X (Twitter) · Schema

Space

Social MediaMicrobloggingReal-Time DataStreamingAdvertisingContent

Properties

Name	Type	Description
created_at	string	Creation time of the Space.
creator_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.
ended_at	string	End time of the Space.
host_ids	array	The user ids for the hosts of the Space.
id	string	The unique identifier of this Space.
invited_user_ids	array	An array of user ids for people who were invited to a Space.
is_ticketed	boolean	Denotes if the Space is a ticketed Space.
lang	string	The language of the Space.
participant_count	integer	The number of participants in a Space.
scheduled_start	string	A date time stamp for when a Space is scheduled to begin.
speaker_ids	array	An array of user ids for people who were speakers in a Space.
started_at	string	When the Space was started as a date string.
state	string	The current state of the Space.
subscriber_count	integer	The number of people who have either purchased a ticket or set a reminder for this Space.
title	string	The title of the Space.
topics	array	The topics of a Space, as selected by its creator.
updated_at	string	When the Space was last updated.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/json-schema/x-api-space-schema.json",
  "title": "Space",
  "description": "",
  "type": "object",
  "properties": {
    "created_at": {
      "type": "string",
      "description": "Creation time of the Space.",
      "format": "date-time",
      "example": "2021-07-06T18:40:40.000Z"
    },
    "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"
    },
    "ended_at": {
      "type": "string",
      "description": "End time of the Space.",
      "format": "date-time",
      "example": "2021-07-06T18:40:40.000Z"
    },
    "host_ids": {
      "type": "array",
      "description": "The user ids for the hosts of the Space.",
      "items": {
        "$ref": "#/components/schemas/UserId"
      }
    },
    "id": {
      "type": "string",
      "description": "The unique identifier of this Space.",
      "pattern": "^[a-zA-Z0-9]{1,13}$",
      "example": "1SLjjRYNejbKM"
    },
    "invited_user_ids": {
      "type": "array",
      "description": "An array of user ids for people who were invited to a Space.",
      "items": {
        "$ref": "#/components/schemas/UserId"
      }
    },
    "is_ticketed": {
      "type": "boolean",
      "description": "Denotes if the Space is a ticketed Space.",
      "example": "false"
    },
    "lang": {
      "type": "string",
      "description": "The language of the Space.",
      "example": "en"
    },
    "participant_count": {
      "type": "integer",
      "description": "The number of participants in a Space.",
      "format": "int32",
      "example": 10
    },
    "scheduled_start": {
      "type": "string",
      "description": "A date time stamp for when a Space is scheduled to begin.",
      "format": "date-time",
      "example": "2021-07-06T18:40:40.000Z"
    },
    "speaker_ids": {
      "type": "array",
      "description": "An array of user ids for people who were speakers in a Space.",
      "items": {
        "$ref": "#/components/schemas/UserId"
      }
    },
    "started_at": {
      "type": "string",
      "description": "When the Space was started as a date string.",
      "format": "date-time",
      "example": "2021-7-14T04:35:55Z"
    },
    "state": {
      "type": "string",
      "description": "The current state of the Space.",
      "enum": [
        "live",
        "scheduled",
        "ended"
      ],
      "example": "live"
    },
    "subscriber_count": {
      "type": "integer",
      "description": "The number of people who have either purchased a ticket or set a reminder for this Space.",
      "format": "int32",
      "example": 10
    },
    "title": {
      "type": "string",
      "description": "The title of the Space.",
      "example": "Spaces are Awesome"
    },
    "topics": {
      "type": "array",
      "description": "The topics of a Space, as selected by its creator.",
      "items": {
        "type": "object",
        "description": "The X Topic object.",
        "required": [
          "id",
          "name"
        ],
        "properties": {
          "description": {
            "type": "string",
            "description": "The description of the given topic."
          },
          "id": {
            "type": "string",
            "description": "An ID suitable for use in the REST API."
          },
          "name": {
            "type": "string",
            "description": "The name of the given topic."
          }
        },
        "example": {
          "description": "All about technology",
          "id": "848920371311001600",
          "name": "Technology"
        }
      }
    },
    "updated_at": {
      "type": "string",
      "description": "When the Space was last updated.",
      "format": "date-time",
      "example": "2021-7-14T04:35:55Z"
    }
  },
  "required": [
    "id",
    "state"
  ]
}