{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/socialdata-tools/json-schema/socialdata-tools-user-schema.json",
  "title": "User",
  "description": "Twitter user account information",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/socialdata-tools-openapi.yml#/components/schemas/User",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "format": "int64",
      "description": "The integer representation of the unique identifier for this User. This number is greater than 53 bits and some programming languages may have difficulty/silent defects in interpreting it. Using a signed 64 bit integer for storing this identifier is safe. Use id_str to fetch the identifier to be safe."
    },
    "id_str": {
      "type": "string",
      "description": "The string representation of the unique identifier for this User. Implementations should use this rather than the large, possibly un-consumable integer in id."
    },
    "name": {
      "type": "string",
      "description": "The name of the user, as they've defined it. Not necessarily a person's name. Typically capped at 50 characters, but subject to change."
    },
    "screen_name": {
      "type": "string",
      "description": "The screen name, handle, or alias that this user identifies themselves with. screen_names are unique but subject to change. Use id_str as a user identifier whenever possible. Typically a maximum of 15 characters long, but some historical accounts may exist with longer names."
    },
    "location": {
      "type": "string",
      "description": "The user-defined location for this account's profile. Not necessarily a location, nor machine-parseable. This field will occasionally be fuzzily interpreted by the Search service."
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "A URL provided by the user in association with their profile."
    },
    "description": {
      "type": "string",
      "description": "The user-defined UTF-8 string describing their account."
    },
    "protected": {
      "type": "boolean",
      "description": "When true, indicates that this user has chosen to protect their Tweets."
    },
    "verified": {
      "type": "boolean",
      "description": "When true, indicates that the user has a verified account with a blue checkmark."
    },
    "followers_count": {
      "type": "integer",
      "description": "The number of followers this account currently has. Under certain conditions of duress, this field will temporarily indicate \"0\"."
    },
    "friends_count": {
      "type": "integer",
      "description": "The number of users this account is following (AKA their \"followings\"). Under certain conditions of duress, this field will temporarily indicate \"0\"."
    },
    "listed_count": {
      "type": "integer",
      "description": "The number of public lists that this user is a member of."
    },
    "favourites_count": {
      "type": "integer",
      "description": "The number of Tweets this user has liked in the account's lifetime. British spelling used in the field name for historical reasons."
    },
    "statuses_count": {
      "type": "integer",
      "description": "The number of Tweets (including retweets) issued by the user."
    },
    "created_at": {
      "type": "string",
      "description": "The UTC datetime that the user account was created on Twitter."
    },
    "profile_banner_url": {
      "type": "string",
      "description": "The HTTPS-based URL pointing to the standard web representation of the user's uploaded profile banner. By adding a final path element of the URL, it is possible to obtain different image sizes optimized for specific displays."
    },
    "profile_image_url_https": {
      "type": "string",
      "description": "A HTTPS-based URL pointing to the user's profile image."
    },
    "can_dm": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indicates whether the authenticated user can send a direct message to this user."
    }
  },
  "required": [
    "id_str",
    "name",
    "screen_name",
    "location",
    "description",
    "protected",
    "verified",
    "followers_count",
    "friends_count",
    "listed_count",
    "favourites_count",
    "statuses_count",
    "created_at",
    "profile_banner_url",
    "profile_image_url_https",
    "can_dm"
  ]
}