Threads · JSON Structure
Threads Api Thread Structure
Structure documentation for Meta Threads API media objects and insights.
Type:
Properties: 0
SocialSocial NetworksMetaPublishingMedia
Threads Api Thread Structure is a JSON Structure definition published by Threads.
Meta-schema:
JSON Structure
{
"title": "Threads API Thread Structure",
"description": "Structure documentation for Meta Threads API media objects and insights.",
"version": "1.0",
"structures": {
"Thread": {
"description": "A Threads post (media object) published on the platform.",
"fields": {
"id": { "type": "string", "required": true, "description": "Unique media object identifier" },
"media_product_type": { "type": "string", "required": false, "description": "Always THREADS" },
"media_type": { "type": "string", "required": true, "description": "TEXT_POST | IMAGE | VIDEO | CAROUSEL_ALBUM | AUDIO | REPOST_FACADE" },
"permalink": { "type": "string", "required": false, "description": "Permanent URL to the post" },
"owner": { "type": "object", "required": false, "description": "Creator user object with id field" },
"username": { "type": "string", "required": false, "description": "Creator username" },
"text": { "type": "string", "required": false, "description": "Post text content" },
"timestamp": { "type": "string", "required": false, "description": "ISO 8601 publication timestamp" },
"shortcode": { "type": "string", "required": false, "description": "Media shortcode" },
"media_url": { "type": "string", "required": false, "description": "Media file URL" },
"thumbnail_url": { "type": "string", "required": false, "description": "Video thumbnail URL" },
"is_quote_post": { "type": "boolean", "required": false, "description": "Whether post quotes another" },
"has_replies": { "type": "boolean", "required": false, "description": "Whether post has replies" },
"is_reply": { "type": "boolean", "required": false, "description": "Whether this is a reply" },
"hide_status": { "type": "string", "required": false, "description": "NOT_HUSHED | UNHUSHED | HIDDEN" },
"root_post": { "type": "object", "required": false, "description": "Top-level post reference for replies" },
"replied_to": { "type": "object", "required": false, "description": "Immediate parent post reference" }
}
},
"Insight": {
"description": "Analytics metric for a post or account.",
"fields": {
"name": { "type": "string", "required": true, "description": "Metric name (views, likes, replies, etc.)" },
"period": { "type": "string", "required": true, "description": "Measurement period (lifetime, day)" },
"values": { "type": "array", "required": true, "description": "Array of metric value objects" },
"title": { "type": "string", "required": false, "description": "Human-readable metric title" },
"description": { "type": "string", "required": false, "description": "Metric description" },
"id": { "type": "string", "required": false, "description": "Insight object identifier" }
}
},
"PaginatedResponse": {
"description": "Standard paginated list response with cursor-based pagination.",
"fields": {
"data": { "type": "array", "required": true, "description": "Array of result objects" },
"paging": {
"type": "object",
"required": false,
"description": "Pagination cursors",
"fields": {
"cursors": {
"type": "object",
"fields": {
"before": { "type": "string", "description": "Cursor to previous page" },
"after": { "type": "string", "description": "Cursor to next page" }
}
}
}
}
}
}
}
}
Work with this as data
Every JSON Structure 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 json structure
4 MCP tools reach this
find_json_structuresBrowse and filter every JSON Structure 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 Structure
curl "https://apis.io/api/v1/json-structures/threads-api-thread-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?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.