Properties
| Name | Type | Description |
|---|---|---|
| entity | string | |
| platform | object | |
| canonical_url | object | |
| data_as_of | object | |
| schema_version | string | |
| common | object | |
| platform_fields | object | |
| freshness | object | |
| usage | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/veezee-io/json-schema/veezee-io-x-search-envelope-schema.json",
"title": "x_search_envelope",
"x-generated": "2026-10-29",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/veezee-io-openapi.json#/components/schemas/x_search_envelope",
"type": "object",
"properties": {
"entity": {
"type": "string",
"const": "x_search"
},
"platform": {
"anyOf": [
{
"type": "string",
"enum": [
"linkedin",
"reddit",
"x"
]
},
{
"type": "null"
}
]
},
"canonical_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"schema_version": {
"type": "string",
"const": "2"
},
"common": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"recent",
"popular",
"people"
],
"description": "Which result array is populated."
},
"tweets": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Numeric tweet id as a string. Pass to x_get_tweet."
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"author": {
"anyOf": [
{
"type": "object",
"properties": {
"screen_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Handle without the @, e.g. 'nasa'."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Numeric account id as a string; stable across handle changes."
},
"followers": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"is_verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Blue-check state."
}
},
"required": [
"screen_name",
"name",
"id",
"followers",
"is_verified"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "ISO 8601."
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Canonical x.com URL."
},
"views": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"likes": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"retweets": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"replies": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"quotes": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"bookmarks": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"lang": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_reply": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"is_retweet": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"is_quote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"in_reply_to_screen_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"conversation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Thread root tweet id; equal to id for thread starters."
},
"possibly_sensitive": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"text",
"author",
"created_at",
"url",
"views",
"likes",
"retweets",
"replies",
"quotes",
"bookmarks",
"lang",
"is_reply",
"is_retweet",
"is_quote",
"in_reply_to_screen_name",
"conversation_id",
"possibly_sensitive"
],
"additionalProperties": false
}
},
{
"type": "null"
}
]
},
"people": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"screen_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Handle without the @, e.g. 'nasa'."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Numeric account id as a string; stable across handle changes."
},
"followers": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"is_verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Blue-check state."
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"screen_name",
"name",
"id",
"followers",
"is_verified",
"description",
"location"
],
"additionalProperties": false
}
},
{
"type": "null"
}
]
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Pass back to fetch the next page. Null when exhausted or for type 'people' (single page)."
},
"next_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"returned_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"truncation_hint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Present when results were cut off; says how to narrow or continue."
}
},
"required": [
"type",
"tweets",
"people",
"cursor",
"next_url",
"returned_count",
"truncation_hint"
],
"additionalProperties": false
},
"platform_fields": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"freshness": {
"anyOf": [
{
"type": "object",
"properties": {
"source_retrieved_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When the data was fetched from the source. ISO 8601."
},
"served_at": {
"type": "string"
},
"cache_age_seconds": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"served_from_cache": {
"type": "boolean",
"description": "True when these bytes were served from cache rather than fetched for this call. source_retrieved_at says how old they are."
},
"freshness_requested": {
"type": "string",
"enum": [
"recent",
"realtime"
]
},
"freshness_served": {
"type": "string",
"enum": [
"recent",
"realtime",
"stale"
]
}
},
"required": [
"source_retrieved_at",
"served_at",
"cache_age_seconds",
"served_from_cache",
"freshness_requested",
"freshness_served"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"usage": {
"type": "object",
"properties": {
"receipt_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"credits_quoted": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"credits_charged": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"balance_remaining": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"free_tier_hint": {
"description": "Present on free-tier trial-key calls: what budget the call drew from and that paying upgrades this same key. Near the daily cap on unclaimed keys it also carries a claim link to relay to your human (claiming adds one-time credits).",
"type": "string"
}
},
"required": [
"receipt_id",
"credits_quoted",
"credits_charged",
"balance_remaining"
],
"additionalProperties": false
}
},
"required": [
"entity",
"platform",
"canonical_url",
"data_as_of",
"schema_version",
"common",
"platform_fields",
"freshness",
"usage"
],
"additionalProperties": false
}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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/veezee-io-x-search-envelope"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.