Openhandle · Schema
SuccessEnvelope
Social DataInstagramTikTokTwitterRedditPublic Datasocial-media-apiMCPcreator-analyticsSocial Listening
Properties
| Name | Type | Description |
|---|---|---|
| capturedAt | string | |
| data | object | |
| meta | object | |
| platform | string | |
| resource | string | |
| source | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/openhandle/json-schema/openhandle-success-envelope-schema.json",
"title": "SuccessEnvelope",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/openhandle-reddit-api-openapi.yml#/components/schemas/SuccessEnvelope",
"additionalProperties": false,
"properties": {
"capturedAt": {
"format": "date-time",
"type": "string"
},
"data": {},
"meta": {
"$ref": "#/$defs/ResponseMeta"
},
"platform": {
"enum": [
"instagram",
"tiktok",
"twitter",
"reddit"
],
"type": "string"
},
"resource": {
"enum": [
"profile",
"post",
"comment",
"hashtag",
"location",
"music",
"category",
"list",
"entity",
"subreddit",
"rule",
"wiki",
"trophy"
],
"type": "string"
},
"source": {
"enum": [
"live",
"cache"
],
"type": "string"
}
},
"required": [
"platform",
"resource",
"capturedAt",
"source",
"data"
],
"type": "object",
"$defs": {
"InstagramAudioMetrics": {
"additionalProperties": false,
"properties": {
"photos": {
"type": [
"integer",
"null"
]
},
"previousTrendRank": {
"type": [
"integer",
"null"
]
},
"reels": {
"type": [
"integer",
"null"
]
},
"trendRank": {
"type": [
"integer",
"null"
]
}
},
"required": [
"trendRank",
"previousTrendRank",
"reels",
"photos"
],
"type": "object"
},
"InstagramAudioPart": {
"additionalProperties": false,
"properties": {
"artist": {
"anyOf": [
{
"$ref": "#/$defs/InstagramProfileReference"
},
{
"type": "null"
}
]
},
"artistName": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"artwork": {
"anyOf": [
{
"$ref": "#/$defs/InstagramImage"
},
{
"type": "null"
}
]
},
"isExplicit": {
"type": [
"boolean",
"null"
]
},
"musicId": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"parentStartTime": {
"type": [
"number",
"null"
]
},
"startTime": {
"type": [
"number",
"null"
]
},
"title": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"type": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"type",
"title",
"artistName",
"isExplicit",
"musicId",
"artist",
"startTime",
"parentStartTime",
"artwork"
],
"type": "object"
},
"InstagramAudioReference": {
"additionalProperties": false,
"properties": {
"artist": {
"anyOf": [
{
"$ref": "#/$defs/InstagramProfileReference"
},
{
"type": "null"
}
]
},
"artistId": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"artistName": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"artwork": {
"anyOf": [
{
"$ref": "#/$defs/InstagramImage"
},
{
"type": "null"
}
]
},
"clusterId": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"compositionStartTime": {
"type": [
"number",
"null"
]
},
"createdAt": {
"format": "date-time",
"minLength": 1,
"type": [
"string",
"null"
]
},
"duration": {
"type": [
"number",
"null"
]
},
"fastStartUrl": {
"format": "uri",
"minLength": 1,
"type": [
"string",
"null"
]
},
"filters": {
"items": {},
"type": [
"array",
"null"
]
},
"hasLyrics": {
"type": [
"boolean",
"null"
]
},
"highlightStartTimes": {
"items": {
"type": "number"
},
"type": [
"array",
"null"
]
},
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"isAutomaticallyAttributed": {
"type": [
"boolean",
"null"
]
},
"isCrosspostedFromFacebook": {
"type": [
"boolean",
"null"
]
},
"isExplicit": {
"type": [
"boolean",
"null"
]
},
"isTrending": {
"type": [
"boolean",
"null"
]
},
"metrics": {
"$ref": "#/$defs/InstagramAudioMetrics"
},
"monetizationType": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"musicId": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"originalPostId": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"overlapDuration": {
"type": [
"number",
"null"
]
},
"parts": {
"items": {
"$ref": "#/$defs/InstagramAudioPart"
},
"type": [
"array",
"null"
]
},
"previewUrl": {
"format": "uri",
"minLength": 1,
"type": [
"string",
"null"
]
},
"spotify": {
"additionalProperties": false,
"properties": {
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"url": {
"format": "uri",
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"url"
],
"type": "object"
},
"startTime": {
"type": [
"number",
"null"
]
},
"streaming": {
"anyOf": [
{
"$ref": "#/$defs/InstagramStreaming"
},
{
"type": "null"
}
]
},
"subtype": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"title": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"type": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"url": {
"format": "uri",
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"type",
"musicId",
"artistId",
"clusterId",
"title",
"artistName",
"artist",
"isExplicit",
"hasLyrics",
"isTrending",
"subtype",
"isAutomaticallyAttributed",
"isCrosspostedFromFacebook",
"monetizationType",
"duration",
"startTime",
"overlapDuration",
"compositionStartTime",
"createdAt",
"originalPostId",
"url",
"fastStartUrl",
"previewUrl",
"artwork",
"streaming",
"highlightStartTimes",
"filters",
"metrics",
"spotify",
"parts"
],
"type": "object"
},
"InstagramBioLink": {
"additionalProperties": false,
"properties": {
"icon": {
"anyOf": [
{
"$ref": "#/$defs/InstagramImage"
},
{
"type": "null"
}
]
},
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"image": {
"anyOf": [
{
"$ref": "#/$defs/InstagramImage"
},
{
"type": "null"
}
]
},
"isPinned": {
"type": [
"boolean",
"null"
]
},
"isVerified": {
"type": [
"boolean",
"null"
]
},
"title": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"type": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"url": {
"format": "uri",
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title",
"url",
"type",
"isPinned",
"isVerified",
"icon",
"image"
],
"type": "object"
},
"InstagramCommentMetrics": {
"additionalProperties": false,
"properties": {
"likes": {
"type": [
"integer",
"null"
]
},
"replies": {
"type": [
"integer",
"null"
]
}
},
"required": [
"likes",
"replies"
],
"type": "object"
},
"InstagramCommentReference": {
"additionalProperties": false,
"properties": {
"ai": {
"additionalProperties": false,
"properties": {
"type": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"type"
],
"type": "object"
},
"author": {
"anyOf": [
{
"$ref": "#/$defs/InstagramProfileReference"
},
{
"type": "null"
}
]
},
"createdAt": {
"format": "date-time",
"minLength": 1,
"type": [
"string",
"null"
]
},
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"isByPostAuthor": {
"type": [
"boolean",
"null"
]
},
"isCovered": {
"type": [
"boolean",
"null"
]
},
"isEdited": {
"type": [
"boolean",
"null"
]
},
"isLikedByPostAuthor": {
"type": [
"boolean",
"null"
]
},
"isPinned": {
"type": [
"boolean",
"null"
]
},
"keywords": {
"items": {},
"type": [
"array",
"null"
]
},
"likedByCoauthors": {
"items": {
"$ref": "#/$defs/InstagramProfileReference"
},
"type": [
"array",
"null"
]
},
"media": {
"items": {
"$ref": "#/$defs/InstagramImage"
},
"type": [
"array",
"null"
]
},
"metrics": {
"$ref": "#/$defs/InstagramCommentMetrics"
},
"parentId": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"pinnedPosition": {
"type": [
"integer",
"null"
]
},
"postId": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"previewUsers": {
"items": {
"$ref": "#/$defs/InstagramProfileReference"
},
"type": [
"array",
"null"
]
},
"ranking": {
"additionalProperties": false,
"properties": {
"index": {
"type": [
"integer",
"null"
]
},
"isRanked": {
"type": [
"boolean",
"null"
]
},
"replyIndex": {
"type": [
"integer",
"null"
]
}
},
"required": [
"index",
"replyIndex",
"isRanked"
],
"type": "object"
},
"replies": {
"items": {
"$ref": "#/$defs/InstagramCommentReference"
},
"type": [
"array",
"null"
]
},
"replyToId": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"sharingEnabled": {
"type": [
"boolean",
"null"
]
},
"status": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"text": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"translation": {
"additionalProperties": false,
"properties": {
"text": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"text"
],
"type": "object"
}
},
"required": [
"id",
"text",
"postId",
"parentId",
"replyToId",
"createdAt",
"author",
"status",
"isCovered",
"isEdited",
"sharingEnabled",
"isByPostAuthor",
"isPinned",
"pinnedPosition",
"isLikedByPostAuthor",
"ai",
"ranking",
"keywords",
"previewUsers",
"metrics",
"replies",
"translation",
"likedByCoauthors",
"media"
],
"type": "object"
},
"InstagramCommentSettings": {
"additionalProperties": false,
"properties": {
"enabled": {
"type": [
"boolean",
"null"
]
},
"hasMore": {
"type": [
"boolean",
"null"
]
},
"likesEnabled": {
"type": [
"boolean",
"null"
]
},
"maxVisiblePreviewComments": {
"type": [
"integer",
"null"
]
},
"preview": {
"items": {
"$ref": "#/$defs/InstagramCommentReference"
},
"type": [
"array",
"null"
]
},
"threadingEnabled": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"hasMore",
"maxVisiblePreviewComments",
"likesEnabled",
"threadingEnabled",
"enabled",
"preview"
],
"type": "object"
},
"InstagramCoordinates": {
"additionalProperties": false,
"properties": {
"latitude": {
"type": [
"number",
"null"
]
},
"longitude": {
"type": [
"number",
"null"
]
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"InstagramCrop": {
"additionalProperties": false,
"properties": {
"bottom": {
"type": [
"number",
"null"
]
},
"left": {
"type": [
"number",
"null"
]
},
"right": {
"type": [
"number",
"null"
]
},
"top": {
"type": [
"number",
"null"
]
}
},
"required": [
"left",
"right",
"top",
"bottom"
],
"type": "object"
},
"InstagramDASH": {
"additionalProperties": false,
"properties": {
"manifest": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"qualityCount": {
"type": [
"integer",
"null"
]
},
"variants": {
"items": {
"$ref": "#/$defs/InstagramStreamVariant"
},
"type": [
"array",
"null"
]
}
},
"required": [
"manifest",
"variants",
"qualityCount"
],
"type": "object"
},
"InstagramImage": {
"additionalProperties": false,
"properties": {
"height": {
"type": [
"integer",
"null"
]
},
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"isDefault": {
"type": [
"boolean",
"null"
]
},
"isSpatial": {
"type": [
"boolean",
"null"
]
},
"thumbnail": {
"anyOf": [
{
"$ref": "#/$defs/InstagramImage"
},
{
"type": "null"
}
]
},
"type": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"url": {
"format": "uri",
"minLength": 1,
"type": [
"string",
"null"
]
},
"variants": {
"items": {
"$ref": "#/$defs/InstagramImage"
},
"type": [
"array",
"null"
]
},
"width": {
"type": [
"integer",
"null"
]
}
},
"required": [
"thumbnail",
"id",
"type",
"url",
"width",
"height",
"isDefault",
"isSpatial",
"variants"
],
"type": "object"
},
"InstagramLocationAddress": {
"additionalProperties": false,
"properties": {
"city": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"countryCode": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"postalCode": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"region": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"street": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"street",
"city",
"postalCode",
"region",
"countryCode"
],
"type": "object"
},
"InstagramLocationHours": {
"additionalProperties": false,
"properties": {
"currentStatus": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"isOpen": {
"type": [
"boolean",
"null"
]
},
"schedule": {
"items": {},
"type": [
"array",
"null"
]
},
"status": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"today": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"status",
"currentStatus",
"today",
"isOpen",
"schedule"
],
"type": "object"
},
"InstagramLocationReference": {
"additionalProperties": false,
"properties": {
"address": {
"$ref": "#/$defs/InstagramLocationAddress"
},
"category": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"coordinates": {
"$ref": "#/$defs/InstagramCoordinates"
},
"external": {
"additionalProperties": false,
"properties": {
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"source": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"source"
],
"type": "object"
},
"hours": {
"anyOf": [
{
"$ref": "#/$defs/InstagramLocationHours"
},
{
"type": "null"
}
]
},
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"name": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"phone": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"searchContext": {
"additionalProperties": false,
"properties": {
"subtitle": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"title": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"title",
"subtitle"
],
"type": "object"
},
"shortName": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"url": {
"format": "uri",
"minLength": 1,
"type": [
"string",
"null"
]
},
"website": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"shortName",
"category",
"url",
"phone",
"website",
"address",
"coordinates",
"external",
"searchContext",
"hours"
],
"type": "object"
},
"InstagramMedia": {
"additionalProperties": false,
"properties": {
"altText": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"audio": {
"anyOf": [
{
"$ref": "#/$defs/InstagramAudioReference"
},
{
"type": "null"
}
]
},
"bitrate": {
"type": [
"integer",
"null"
]
},
"commercialityStatus": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"createdAt": {
"format": "date-time",
"minLength": 1,
"type": [
"string",
"null"
]
},
"crops": {
"additionalProperties": false,
"properties": {
"feedPreview": {
"$ref": "#/$defs/InstagramCrop"
},
"fourByThree": {
"$ref": "#/$defs/InstagramCrop"
},
"square": {
"$ref": "#/$defs/InstagramCrop"
}
},
"required": [
"fourByThree",
"square",
"feedPreview"
],
"type": "object"
},
"duration": {
"type": [
"number",
"null"
]
},
"firstFrame": {
"anyOf": [
{
"$ref": "#/$defs/InstagramImage"
},
{
"type": "null"
}
]
},
"hasAudio": {
"type": [
"boolean",
"null"
]
},
"height": {
"type": [
"integer",
"null"
]
},
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"originalHeight": {
"type": [
"integer",
"null"
]
},
"originalWidth": {
"type": [
"integer",
"null"
]
},
"parentId": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"productTags": {
"items": {
"$ref": "#/$defs/InstagramProductTag"
},
"type": [
"array",
"null"
]
},
"scrubber": {
"anyOf": [
{
"$ref": "#/$defs/InstagramScrubber"
},
{
"type": "null"
}
]
},
"streaming": {
"anyOf": [
{
"$ref": "#/$defs/InstagramStreaming"
},
{
"type": "null"
}
]
},
"subtitles": {
"anyOf": [
{
"$ref": "#/$defs/InstagramSubtitles"
},
{
"type": "null"
}
]
},
"taggedUsers": {
"items": {
"$ref": "#/$defs/InstagramUserTag"
},
"type": [
"array",
"null"
]
},
"thumbnail": {
"anyOf": [
{
"$ref": "#/$defs/InstagramImage"
},
{
"type": "null"
}
]
},
"type": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"url": {
"format": "uri",
"minLength": 1,
"type": [
"string",
"null"
]
},
"variants": {
"items": {
"$ref": "#/$defs/InstagramMediaVariant"
},
"type": [
"array",
"null"
]
},
"width": {
"type": [
"integer",
"null"
]
}
},
"required": [
"id",
"type",
"parentId",
"createdAt",
"url",
"width",
"height",
"originalWidth",
"originalHeight",
"bitrate",
"hasAudio",
"altText",
"commercialityStatus",
"duration",
"variants",
"thumbnail",
"firstFrame",
"scrubber",
"streaming",
"subtitles",
"audio",
"taggedUsers",
"productTags",
"crops"
],
"type": "object"
},
"InstagramMediaPreview": {
"additionalProperties": false,
"properties": {
"fbid": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"thumbnail": {
"anyOf": [
{
"$ref": "#/$defs/InstagramImage"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"fbid",
"thumbnail"
],
"type": "object"
},
"InstagramMediaVariant": {
"additionalProperties": false,
"properties": {
"bitrate": {
"type": [
"integer",
"null"
]
},
"height": {
"type": [
"integer",
"null"
]
},
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"isSpatial": {
"type": [
"boolean",
"null"
]
},
"type": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"url": {
"format": "uri",
"minLength": 1,
"type": [
"string",
"null"
]
},
"width": {
"type": [
"integer",
"null"
]
}
},
"required": [
"id",
"type",
"url",
"width",
"height",
"bitrate",
"isSpatial"
],
"type": "object"
},
"InstagramNote": {
"additionalProperties": false,
"properties": {
"author": {
"anyOf": [
{
"$ref": "#/$defs/InstagramProfileReference"
},
{
"type": "null"
}
]
},
"createdAt": {
"format": "date-time",
"minLength": 1,
"type": [
"string",
"null"
]
},
"id": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"text": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"text",
"createdAt",
"author"
],
"type": "object"
},
"InstagramPosition": {
"additionalProperties": false,
"properties": {
"x": {
"type": [
"number",
"null"
]
},
"y": {
"type": [
"number",
"null"
]
}
},
"required": [
"x",
"y"
],
"type": "object"
},
"InstagramPostMetrics": {
"additionalProperties": false,
"properties": {
"comments": {
"type": [
"integer",
"null"
]
},
"facebook": {
"additionalProperties": false,
"properties": {
"comments": {
"type": [
"integer",
"null"
]
},
# --- truncated at 32 KB (164 KB total) ---
# Full source: https://artifacts.apis.io/openhandle/json-schema/openhandle-success-envelope-schema.json
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/openhandle-success-envelope"
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.