twexapi-io · Schema

SearchResponse

Search API response

SocialDataXCreditArtificial Intelligence

Properties

Name Type Description
code integer HTTP status code
msg string Response message
data array List of tweets
View JSON Schema on GitHub

JSON Schema

twexapi-io-search-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/twexapi-io/json-schema/twexapi-io-search-response-schema.json",
  "title": "SearchResponse",
  "description": "Search API response",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twexapi-io-all-tweets-replies-endpoints-api-openapi.yml#/components/schemas/SearchResponse",
  "properties": {
    "code": {
      "type": "integer",
      "title": "Code",
      "description": "HTTP status code",
      "default": 200
    },
    "msg": {
      "type": "string",
      "title": "Msg",
      "description": "Response message",
      "default": "success"
    },
    "data": {
      "items": {
        "$ref": "#/$defs/TweetModel_2"
      },
      "type": "array",
      "title": "Data",
      "description": "List of tweets"
    }
  },
  "type": "object",
  "required": [
    "data"
  ],
  "$defs": {
    "MediaModel": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id",
          "description": "Media ID"
        },
        "type": {
          "type": "string",
          "title": "Type",
          "description": "Type of media (e.g., photo, video)"
        },
        "display_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Display Url",
          "description": "URL of the media to display"
        },
        "expanded_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Expanded Url",
          "description": "Expanded URL for the media"
        },
        "media_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Media Url",
          "description": "Direct URL to the media file"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Url",
          "description": "t.co URL for the media"
        },
        "height": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Height",
          "description": "Height of the media in pixels"
        },
        "width": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Width",
          "description": "Width of the media in pixels"
        },
        "features": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Features",
          "description": "Features of the media"
        },
        "original_info": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Original Info",
          "description": "Original information about the media"
        },
        "sizes": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sizes",
          "description": "Available sizes of the media"
        },
        "source_status_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Source Status Id",
          "description": "Source tweet ID if the media is a retweet"
        },
        "source_user_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Source User Id",
          "description": "Source user ID if the media is a retweet"
        },
        "duration_millis": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Duration Millis",
          "description": "Duration of the video in milliseconds"
        },
        "aspect_ratio": {
          "anyOf": [
            {
              "items": {
                "type": "integer"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Aspect Ratio",
          "description": "Aspect ratio of the video"
        },
        "video_info": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Video Info",
          "description": "Detailed video information"
        },
        "streams": {
          "items": {
            "$ref": "#/$defs/StreamModel"
          },
          "type": "array",
          "title": "Streams",
          "description": "List of available video streams",
          "default": []
        }
      },
      "type": "object",
      "required": [
        "id",
        "type"
      ],
      "title": "MediaModel"
    },
    "StreamModel": {
      "properties": {
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Url",
          "description": "URL of the video stream"
        },
        "bitrate": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Bitrate",
          "description": "Bitrate of the video stream in bps"
        },
        "content_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Content Type",
          "description": "Content type of the stream"
        }
      },
      "type": "object",
      "title": "StreamModel"
    },
    "TweetModel_2": {
      "properties": {
        "tweet_id": {
          "type": "string",
          "title": "Tweet Id",
          "description": "The unique identifier for the Tweet"
        },
        "is_paid_promotion": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Is Paid Promotion",
          "description": "Indicates whether the content or user is associated with a paid promotion",
          "default": false
        },
        "text": {
          "type": "string",
          "title": "Text",
          "description": "The actual text content of the Tweet"
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Created At",
          "description": "The date and time the Tweet was created"
        },
        "created_at_datetime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Created At Datetime",
          "description": "The ISO 8601 format of the creation date"
        },
        "bookmark_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Bookmark Count",
          "description": "Number of times the Tweet has been bookmarked",
          "default": 0
        },
        "bookmarked": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Bookmarked",
          "description": "Indicates if the authenticating user has bookmarked this Tweet",
          "default": false
        },
        "community_note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Community Note",
          "description": "Community note associated with the Tweet"
        },
        "edit_tweet_ids": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Edit Tweet Ids",
          "description": "A list of Tweet IDs for each edit of the Tweet",
          "default": []
        },
        "editable_until_msecs": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Editable Until Msecs",
          "description": "Timestamp for when the Tweet is no longer editable"
        },
        "edits_remaining": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Edits Remaining",
          "description": "Number of edits remaining for the Tweet"
        },
        "favorite_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Favorite Count",
          "description": "Number of likes (favorites) for the Tweet",
          "default": 0
        },
        "favorited": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Favorited",
          "description": "Indicates if the authenticating user has liked this Tweet",
          "default": false
        },
        "full_text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Full Text",
          "description": "The full text of the Tweet, especially for extended tweets"
        },
        "has_card": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Has Card",
          "description": "Indicates if the Tweet has a card attached",
          "default": false
        },
        "has_community_notes": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Has Community Notes",
          "description": "Indicates if the Tweet has community notes",
          "default": false
        },
        "hashtags": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Hashtags",
          "description": "A list of hashtags mentioned in the Tweet",
          "default": []
        },
        "cashtags": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Cashtags",
          "description": "A list of cashtags (stock symbols) mentioned in the Tweet",
          "default": []
        },
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Id",
          "description": "The unique identifier for the Tweet (same as tweet_id)"
        },
        "in_reply_to": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "In Reply To",
          "description": "ID of the Tweet this is a reply to"
        },
        "in_reply_to_user_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "In Reply To User Id",
          "description": "ID of the user this is a reply to"
        },
        "in_reply_to_screen_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "In Reply To Screen Name",
          "description": "Screen name of the user this is a reply to"
        },
        "is_edit_eligible": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Is Edit Eligible",
          "description": "Indicates if the Tweet is eligible for editing",
          "default": false
        },
        "is_quote_status": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Is Quote Status",
          "description": "Indicates if this Tweet is a quote of another Tweet",
          "default": false
        },
        "quoted_status_id_str": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Quoted Status Id Str",
          "description": "The unique identifier for the Tweet that this is a quote of"
        },
        "is_translatable": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Is Translatable",
          "description": "Indicates if the Tweet is translatable",
          "default": false
        },
        "lang": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Lang",
          "description": "The BCP 47 language identifier for the Tweet's content"
        },
        "media": {
          "items": {
            "$ref": "#/$defs/MediaModel"
          },
          "type": "array",
          "title": "Media",
          "description": "A list of media objects (photos, videos) attached to the Tweet",
          "default": []
        },
        "place": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Place",
          "description": "The location associated with the Tweet"
        },
        "poll": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Poll",
          "description": "A poll attached to the Tweet"
        },
        "possibly_sensitive": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Possibly Sensitive",
          "description": "Indicates if the Tweet may contain sensitive content"
        },
        "possibly_sensitive_editable": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Possibly Sensitive Editable",
          "description": "Indicates if the sensitive content flag is editable"
        },
        "quote": {
          "anyOf": [
            {
              "$ref": "#/$defs/TweetModel_2"
            },
            {
              "type": "null"
            }
          ],
          "description": "The Tweet object being quoted"
        },
        "quote_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Quote Count",
          "description": "Number of times this Tweet has been quoted",
          "default": 0
        },
        "related_tweets": {
          "items": {
            "$ref": "#/$defs/TweetModel_2"
          },
          "type": "array",
          "title": "Related Tweets",
          "description": "A list of related Tweets",
          "default": []
        },
        "replies": {
          "items": {
            "$ref": "#/$defs/TweetModel_2"
          },
          "type": "array",
          "title": "Replies",
          "description": "A list of replies to this Tweet",
          "default": []
        },
        "reply_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reply Count",
          "description": "Number of replies to this Tweet",
          "default": 0
        },
        "reply_to": {
          "anyOf": [
            {
              "$ref": "#/$defs/TweetModel_2"
            },
            {
              "type": "null"
            }
          ],
          "description": "The Tweet object this is a reply to"
        },
        "retweet_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Retweet Count",
          "description": "Number of times this Tweet has been retweeted",
          "default": 0
        },
        "retweeted_tweet": {
          "anyOf": [
            {
              "$ref": "#/$defs/TweetModel_2"
            },
            {
              "type": "null"
            }
          ],
          "description": "The original Tweet object if this is a retweet"
        },
        "thread": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/TweetModel_2"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Thread",
          "description": "The conversation thread ID"
        },
        "thumbnail_title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Thumbnail Title",
          "description": "Title for the thumbnail in a card"
        },
        "thumbnail_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Thumbnail Url",
          "description": "URL for the thumbnail in a card"
        },
        "urls": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Urls",
          "description": "A list of URLs included in the Tweet",
          "default": []
        },
        "user": {
          "anyOf": [
            {
              "$ref": "#/$defs/UserModel_2"
            },
            {
              "type": "null"
            }
          ],
          "description": "The user who posted the Tweet"
        },
        "view_count": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "View Count",
          "description": "Number of views for the Tweet"
        },
        "view_count_state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "View Count State",
          "description": "State of the view count"
        },
        "status": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Status",
          "description": "Raw status dictionary"
        },
        "target_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Target Count",
          "description": "The target count of items requested, for context"
        }
      },
      "type": "object",
      "required": [
        "tweet_id",
        "text"
      ],
      "title": "TweetModel"
    },
    "UserModel_2": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id",
          "description": "User ID"
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "Display name"
        },
        "screen_name": {
          "type": "string",
          "title": "Screen Name",
          "description": "Twitter username"
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Created At",
          "description": "Account creation date"
        },
        "created_at_datetime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Created At Datetime",
          "description": "Account creation datetime in ISO format"
        },
        "can_media_tag": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Can Media Tag",
          "description": "Whether the user can be tagged in media",
          "default": false
        },
        "default_profile": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Default Profile",
          "description": "Whether the user has a default profile",
          "default": false
        },
        "default_profile_image": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Default Profile Image",
          "description": "Whether the user has a default profile image",
          "default": false
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Description",
          "description": "User's bio description",
          "default": ""
        },
        "description_urls": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Description Urls",
          "description": "List of URLs found in the user's description",
          "default": []
        },
        "urls": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/urlModel"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Urls",
          "description": "List of URLs found in the user's profile"
        },
        "fast_followers_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fast Followers Count",
          "description": "Count of fast followers",
          "default": 0
        },
        "favourites_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Favourites Count",
          "description": "Number of tweets the user has liked",
          "default": 0
        },
        "followers_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Followers Count",
          "description": "Number of followers",
          "default": 0
        },
        "following_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Following Count",
          "description": "Number of users this user is following",
          "default": 0
        },
        "has_custom_timelines": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Has Custom Timelines",
          "description": "Whether the user has custom timelines",
          "default": false
        },
        "is_blue_verified": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Is Blue Verified",
          "description": "Blue verification status",
          "default": false
        },
        "verified_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Verified Type",
          "description": "Verification badge type when not blue-only: blue, business, government, etc."
        },
        "is_verified": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Is Verified",
          "description": "True if the account has any verification badge (blue, business, government, or legacy verified)",
          "default": false
        },
        "profile_image_shape": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Profile Image Shape",
          "description": "Profile image shape (Circle or Square; Square often indicates business/government)"
        },
        "is_translator": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Is Translator",
          "description": "Whether the user is a translator",
          "default": false
        },
        "listed_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Listed Count",
          "description": "Number of public lists the user is a member of",
          "default": 0
        },
        "location": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Location",
          "description": "User's location",
          "default": ""
        },
        "media_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Media Count",
          "description": "Number of media tweets posted by the user",
          "default": 0
        },
        "normal_followers_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Normal Followers Count",
          "description": "Count of normal followers",
          "default": 0
        },
        "pinned_tweet_ids": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Pinned Tweet Ids",
          "description": "List of pinned tweet IDs",
          "default": []
        },
        "possibly_sensitive": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Possibly Sensitive",
          "description": "Whether the user's profile may contain sensitive content",
          "default": false
        },
        "profile_banner_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Profile Banner Url",
          "description": "URL of the user's profile banner"
        },
        "profile_image_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Profile Image Url",
          "description": "URL of the user's profile image"
        },
        "protected": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Protected",
          "description": "Whether the user's tweets are protected",
          "default": false
        },
        "statuses_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Statuses Count",
          "description": "Number of tweets posted by the user",
          "default": 0
        }
      },
      "type": "object",
      "required": [
        "id",
        "name",
        "screen_name"
      ],
      "title": "UserModel"
    },
    "urlModel": {
      "properties": {
        "url": {
          "type": "string",
          "title": "Url",
          "description": "URL"
        },
        "expanded_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Expanded Url",
          "description": "Expanded URL"
        },
        "display_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Display Url",
          "description": "Display URL"
        }
      },
      "type": "object",
      "required": [
        "url"
      ],
      "title": "urlModel"
    }
  }
}

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/twexapi-io-search-response"
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.