socialdata-tools · Schema

User

Twitter user account information

CompanySocial MediaDataPublic APIs

Properties

Name Type Description
id integer 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 sig
id_str string 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 string 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 string 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
location string 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 stringnull A URL provided by the user in association with their profile.
description string The user-defined UTF-8 string describing their account.
protected boolean When true, indicates that this user has chosen to protect their Tweets.
verified boolean When true, indicates that the user has a verified account with a blue checkmark.
followers_count integer The number of followers this account currently has. Under certain conditions of duress, this field will temporarily indicate "0".
friends_count integer The number of users this account is following (AKA their "followings"). Under certain conditions of duress, this field will temporarily indicate "0".
listed_count integer The number of public lists that this user is a member of.
favourites_count integer 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 integer The number of Tweets (including retweets) issued by the user.
created_at string The UTC datetime that the user account was created on Twitter.
profile_banner_url string 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 optimiz
profile_image_url_https string A HTTPS-based URL pointing to the user's profile image.
can_dm booleannull Indicates whether the authenticated user can send a direct message to this user.
View JSON Schema on GitHub

JSON Schema

socialdata-tools-user-schema.json Raw ↑
{
  "$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"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/socialdata-tools-user"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.