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

Raw ↑
{
  "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.
All 92 tools

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 email required.

A second provider on the same verified email joins the account you already have.