socialdata-tools · Schema

TweetWithMarkdown

CompanySocial MediaDataPublic APIs

Properties

Name Type Description
tweet_created_at string The UTC datetime when the tweet was created
id integer The integer representation of the unique identifier for this Tweet. This number is greater than 53 bits and some programming languages may have difficulty/silent defects in interpreting it. Using a si
id_str string The string representation of the unique identifier for this Tweet. Implementations should use this rather than the large integer in id.
text stringnull Deprecated. Always `null`
full_text string 100 tips I learned growing an iOS app to ~$5M in sales in 3 yrs, going through YC 1.5 times, and co-founding @Superwall 👇
source string Utility used to post the Tweet, as an HTML-formatted string. Tweets from the Twitter website have a source value of web.
truncated boolean Indicates whether the value of the text parameter was truncated, for example, as a result of a retweet exceeding the original Tweet text length limit of 140 characters. Since Twitter now rejects long
in_reply_to_status_id integernull If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet's ID.
in_reply_to_status_id_str stringnull If the represented Tweet is a reply, this field will contain the string representation of the original Tweet's ID.
in_reply_to_user_id integernull If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet's author ID. This will not necessarily always be the user directly mentioned in the Tweet.
in_reply_to_user_id_str stringnull If the represented Tweet is a reply, this field will contain the string representation of the original Tweet's author ID. This will not necessarily always be the user directly mentioned in the Tweet.
in_reply_to_screen_name stringnull If the represented Tweet is a reply, this field will contain the screen name of the original Tweet's author.
user object The user who posted this Tweet.
lang string Nullable. When present, indicates a BCP 47 language identifier corresponding to the machine-detected language of the Tweet text, or und if no language could be detected.
quoted_status_id integernull This field only surfaces when the Tweet is a quote Tweet. This field contains the integer value Tweet ID of the quoted Tweet.
quoted_status_id_str stringnull This field only surfaces when the Tweet is a quote Tweet. This is the string representation Tweet ID of the quoted Tweet.
is_quote_status boolean Indicates whether this is a Quoted Tweet.
is_pinned boolean Indicates if the tweet is pinned to the user's profile.
quote_count integer Nullable. Indicates approximately how many times this Tweet has been quoted by Twitter users.
reply_count integer Number of times this Tweet has been replied to.
retweet_count integer Number of times this Tweet has been retweeted.
favorite_count integer Nullable. Indicates approximately how many times this Tweet has been liked by Twitter users.
views_count integer Number of views this tweet has received.
bookmark_count integer Number of times this tweet has been bookmarked.
quoted_status objectnull This field only surfaces when the Tweet is a quote Tweet. This attribute contains the Tweet object of the original Tweet that was quoted.
retweeted_status objectnull Users can amplify the broadcast of Tweets authored by other users by retweeting. Retweets can be distinguished from typical Tweets by the existence of a retweeted_status attribute. This attribute cont
entities object Entities which have been parsed out of the text of the Tweet such as hashtags, URLs, user mentions, media, and symbols.
markdown string The article body rendered as Markdown, or the post's own text rendered as Markdown when markdown_source is tweet_text
markdown_source string Whether the requested ID turned out to be a real article or an ordinary long post. Branch on this rather than assuming.
article objectnull Article metadata. Null when markdown_source is tweet_text. Unlike the v1 Get Article endpoint, this object does not contain content_state or media_entities.
View JSON Schema on GitHub

JSON Schema

socialdata-tools-tweet-with-markdown-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/socialdata-tools/json-schema/socialdata-tools-tweet-with-markdown-schema.json",
  "title": "TweetWithMarkdown",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/socialdata-tools-openapi.yml#/components/schemas/TweetWithMarkdown",
  "allOf": [
    {
      "$ref": "#/$defs/Tweet"
    },
    {
      "type": "object",
      "properties": {
        "markdown": {
          "type": "string",
          "description": "The article body rendered as Markdown, or the post's own text rendered as Markdown when markdown_source is tweet_text"
        },
        "markdown_source": {
          "type": "string",
          "enum": [
            "article",
            "tweet_text"
          ],
          "description": "Whether the requested ID turned out to be a real article or an ordinary long post. Branch on this rather than assuming."
        },
        "article": {
          "type": [
            "object",
            "null"
          ],
          "allOf": [
            {
              "$ref": "#/$defs/ArticleMeta"
            }
          ],
          "description": "Article metadata. Null when markdown_source is tweet_text. Unlike the v1 Get Article endpoint, this object does not contain content_state or media_entities."
        }
      },
      "required": [
        "markdown",
        "markdown_source"
      ]
    }
  ],
  "$defs": {
    "ArticleMeta": {
      "type": "object",
      "description": "Article metadata, without the article body",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int64"
        },
        "id_str": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "preview_text": {
          "type": "string",
          "description": "The opening of the article, as plain text"
        },
        "cover_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "published_at": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "id_str",
        "title"
      ]
    },
    "HashtagEntity": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Name of the hashtag, minus the leading '#' character."
        },
        "indices": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "An array of integers representing offsets within the Tweet text where the hashtag begins and ends."
        }
      }
    },
    "MediaEntity": {
      "type": "object",
      "properties": {
        "id_str": {
          "type": "string",
          "description": "ID of the media expressed as a string."
        },
        "media_url_https": {
          "type": "string",
          "description": "HTTPS URL pointing directly to the uploaded media file."
        },
        "url": {
          "type": "string",
          "description": "Wrapped URL for the media link."
        },
        "display_url": {
          "type": "string",
          "description": "URL of the media to display to clients."
        },
        "expanded_url": {
          "type": "string",
          "description": "Expanded version of display_url."
        },
        "type": {
          "type": "string",
          "enum": [
            "photo",
            "video",
            "animated_gif"
          ],
          "description": "Type of uploaded media."
        },
        "indices": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "An array of integers representing offsets within the Tweet text where the media begins and ends."
        }
      }
    },
    "PollChoice": {
      "type": "object",
      "description": "Represents a single choice in a poll",
      "properties": {
        "label": {
          "type": "string",
          "description": "The text of the poll choice"
        },
        "count": {
          "type": "integer",
          "description": "The number of votes for this choice"
        }
      },
      "required": [
        "label",
        "count"
      ]
    },
    "PollEntity": {
      "type": "object",
      "description": "Represents a poll attached to a Tweet",
      "properties": {
        "end_datetime": {
          "type": "string",
          "format": "date-time",
          "description": "The UTC datetime when the poll will end"
        },
        "duration_minutes": {
          "type": "integer",
          "description": "The duration of the poll in minutes"
        },
        "counts_are_final": {
          "type": "boolean",
          "description": "Indicates whether the voting period has ended and the results are final"
        },
        "choices": {
          "type": "array",
          "description": "An array of poll choices",
          "minItems": 2,
          "maxItems": 4,
          "items": {
            "$ref": "#/$defs/PollChoice"
          }
        }
      },
      "required": [
        "end_datetime",
        "duration_minutes",
        "counts_are_final",
        "choices"
      ]
    },
    "SymbolEntity": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Name of the cashtag, minus the leading '$' character."
        },
        "indices": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "An array of integers representing offsets within the Tweet text where the symbol begins and ends."
        }
      }
    },
    "Tweet": {
      "type": "object",
      "description": "Represents a Tweet object with all its properties",
      "properties": {
        "tweet_created_at": {
          "type": "string",
          "description": "The UTC datetime when the tweet was created"
        },
        "id": {
          "type": "integer",
          "format": "int64",
          "description": "The integer representation of the unique identifier for this Tweet. 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 Tweet. Implementations should use this rather than the large integer in id."
        },
        "text": {
          "type": [
            "string",
            "null"
          ],
          "description": "Deprecated. Always `null`"
        },
        "full_text": {
          "type": "string",
          "description": "100 tips I learned growing an iOS app to ~$5M in sales in 3 yrs, going through YC 1.5 times, and co-founding @Superwall 👇"
        },
        "source": {
          "type": "string",
          "description": "Utility used to post the Tweet, as an HTML-formatted string. Tweets from the Twitter website have a source value of web."
        },
        "truncated": {
          "type": "boolean",
          "description": "Indicates whether the value of the text parameter was truncated, for example, as a result of a retweet exceeding the original Tweet text length limit of 140 characters. Since Twitter now rejects long Tweets vs truncating them, the large majority of Tweets will have this set to false."
        },
        "in_reply_to_status_id": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64",
          "description": "If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet's ID."
        },
        "in_reply_to_status_id_str": {
          "type": [
            "string",
            "null"
          ],
          "description": "If the represented Tweet is a reply, this field will contain the string representation of the original Tweet's ID."
        },
        "in_reply_to_user_id": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64",
          "description": "If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet's author ID. This will not necessarily always be the user directly mentioned in the Tweet."
        },
        "in_reply_to_user_id_str": {
          "type": [
            "string",
            "null"
          ],
          "description": "If the represented Tweet is a reply, this field will contain the string representation of the original Tweet's author ID. This will not necessarily always be the user directly mentioned in the Tweet."
        },
        "in_reply_to_screen_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "If the represented Tweet is a reply, this field will contain the screen name of the original Tweet's author."
        },
        "user": {
          "allOf": [
            {
              "$ref": "#/$defs/User"
            }
          ],
          "description": "The user who posted this Tweet."
        },
        "lang": {
          "type": "string",
          "description": "Nullable. When present, indicates a BCP 47 language identifier corresponding to the machine-detected language of the Tweet text, or und if no language could be detected."
        },
        "quoted_status_id": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64",
          "description": "This field only surfaces when the Tweet is a quote Tweet. This field contains the integer value Tweet ID of the quoted Tweet."
        },
        "quoted_status_id_str": {
          "type": [
            "string",
            "null"
          ],
          "description": "This field only surfaces when the Tweet is a quote Tweet. This is the string representation Tweet ID of the quoted Tweet."
        },
        "is_quote_status": {
          "type": "boolean",
          "description": "Indicates whether this is a Quoted Tweet."
        },
        "is_pinned": {
          "type": "boolean",
          "description": "Indicates if the tweet is pinned to the user's profile."
        },
        "quote_count": {
          "type": "integer",
          "description": "Nullable. Indicates approximately how many times this Tweet has been quoted by Twitter users."
        },
        "reply_count": {
          "type": "integer",
          "description": "Number of times this Tweet has been replied to."
        },
        "retweet_count": {
          "type": "integer",
          "description": "Number of times this Tweet has been retweeted."
        },
        "favorite_count": {
          "type": "integer",
          "description": "Nullable. Indicates approximately how many times this Tweet has been liked by Twitter users."
        },
        "views_count": {
          "type": "integer",
          "description": "Number of views this tweet has received."
        },
        "bookmark_count": {
          "type": "integer",
          "description": "Number of times this tweet has been bookmarked."
        },
        "quoted_status": {
          "type": [
            "object",
            "null"
          ],
          "allOf": [
            {
              "$ref": "#/$defs/Tweet"
            }
          ],
          "description": "This field only surfaces when the Tweet is a quote Tweet. This attribute contains the Tweet object of the original Tweet that was quoted."
        },
        "retweeted_status": {
          "type": [
            "object",
            "null"
          ],
          "allOf": [
            {
              "$ref": "#/$defs/Tweet"
            }
          ],
          "description": "Users can amplify the broadcast of Tweets authored by other users by retweeting. Retweets can be distinguished from typical Tweets by the existence of a retweeted_status attribute. This attribute contains a representation of the original Tweet that was retweeted."
        },
        "entities": {
          "allOf": [
            {
              "$ref": "#/$defs/TweetEntities"
            }
          ],
          "description": "Entities which have been parsed out of the text of the Tweet such as hashtags, URLs, user mentions, media, and symbols."
        }
      },
      "required": [
        "tweet_created_at",
        "id",
        "id_str",
        "full_text",
        "source",
        "truncated",
        "user",
        "lang",
        "is_quote_status",
        "is_pinned",
        "quote_count",
        "reply_count",
        "retweet_count",
        "favorite_count",
        "views_count",
        "bookmark_count",
        "entities"
      ]
    },
    "TweetEntities": {
      "type": "object",
      "description": "Entities which have been parsed out of the text of the Tweet",
      "properties": {
        "urls": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/UrlEntity"
          }
        },
        "user_mentions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/UserMentionEntity"
          }
        },
        "hashtags": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/HashtagEntity"
          }
        },
        "symbols": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/SymbolEntity"
          }
        },
        "media": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/MediaEntity"
          }
        },
        "poll": {
          "$ref": "#/$defs/PollEntity"
        }
      },
      "required": [
        "urls",
        "user_mentions",
        "hashtags",
        "symbols"
      ]
    },
    "UrlEntity": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "description": "Wrapped URL, corresponding to the value embedded directly into the raw Tweet text."
        },
        "expanded_url": {
          "type": "string",
          "description": "Expanded version of display_url."
        },
        "display_url": {
          "type": "string",
          "description": "URL pasted/typed into Tweet."
        },
        "indices": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "An array of integers representing offsets within the Tweet text where the URL begins and ends."
        }
      }
    },
    "User": {
      "type": "object",
      "description": "Twitter user account information",
      "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"
      ]
    },
    "UserMentionEntity": {
      "type": "object",
      "properties": {
        "id_str": {
          "type": "string",
          "description": "ID of the mentioned user, as a string."
        },
        "name": {
          "type": "string",
          "description": "Display name of the referenced user."
        },
        "screen_name": {
          "type": "string",
          "description": "Screen name of the referenced user."
        },
        "indices": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "An array of integers representing offsets within the Tweet text where the user mention begins and ends."
        }
      }
    }
  }
}

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-tweet-with-markdown"
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.