creatordb-app · Schema

InstagramPerformanceHistoryData

The historical performance metrics of the specified Instagram account.

CompanyCreator DataInfluencer MarketingAPIAnalyticsAsia

Properties

Name Type Description
histories array Historical performance snapshots, each containing metrics and a corresponding Unix timestamp in milliseconds.
View JSON Schema on GitHub

JSON Schema

creatordb-app-instagram-performance-history-data-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/creatordb-app/json-schema/creatordb-app-instagram-performance-history-data-schema.json",
  "title": "InstagramPerformanceHistoryData",
  "description": "The historical performance metrics of the specified Instagram account.",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/creatordb-app-openapi.yaml#/components/schemas/InstagramPerformanceHistoryData",
  "type": "object",
  "properties": {
    "histories": {
      "type": "array",
      "description": "Historical performance snapshots, each containing metrics and a corresponding Unix timestamp in milliseconds.",
      "items": {
        "type": "object",
        "description": "A snapshot of the performance metrics on the specified date.",
        "properties": {
          "timestamp": {
            "type": "integer",
            "description": "The performance snapshot date, represented as a Unix timestamp in milliseconds.",
            "exclusiveMinimum": 0
          },
          "totalFollowers": {
            "type": "integer",
            "description": "Total number of followers.",
            "minimum": 0
          },
          "totalFollowing": {
            "type": "integer",
            "description": "Total number of accounts followed.",
            "minimum": 0
          },
          "totalContents": {
            "type": "integer",
            "description": "Total number of posts.",
            "minimum": 0
          },
          "imagesPerformanceRecent": {
            "type": "object",
            "description": "Performance metrics of the image posts for the specified time period.",
            "properties": {
              "likes": {
                "type": "object",
                "properties": {
                  "all": {
                    "type": "integer",
                    "description": "Total number of likes.",
                    "minimum": 0
                  },
                  "avg": {
                    "type": "number",
                    "description": "Average number of likes per image post, rounded to an integer.",
                    "minimum": 0
                  },
                  "median": {
                    "type": "number",
                    "description": "Median number of likes.",
                    "minimum": 0
                  },
                  "min": {
                    "type": "number",
                    "description": "Minimum number of likes.",
                    "minimum": 0
                  },
                  "max": {
                    "type": "number",
                    "description": "Maximum number of likes.",
                    "minimum": 0
                  }
                },
                "required": [
                  "all",
                  "avg",
                  "median",
                  "min",
                  "max"
                ]
              },
              "comments": {
                "type": "object",
                "properties": {
                  "all": {
                    "type": "integer",
                    "description": "Total number of comments.",
                    "minimum": 0
                  },
                  "avg": {
                    "type": "number",
                    "description": "Average number of comments per image post, rounded to an integer.",
                    "minimum": 0
                  },
                  "median": {
                    "type": "number",
                    "description": "Median number of comments.",
                    "minimum": 0
                  },
                  "min": {
                    "type": "number",
                    "description": "Minimum number of comments.",
                    "minimum": 0
                  },
                  "max": {
                    "type": "number",
                    "description": "Maximum number of comments.",
                    "minimum": 0
                  }
                },
                "required": [
                  "all",
                  "avg",
                  "median",
                  "min",
                  "max"
                ]
              },
              "engagement": {
                "type": "object",
                "description": "Engagement performance metrics including rates, per-follower statistics, and consistency analysis.",
                "properties": {
                  "avgEngagementRate": {
                    "type": "number",
                    "description": "Average engagement rate per Instagram image post (excluding older pinned image posts), rounded to 4th decimal place. <br />\n  - *Engagement Rate &#61; (Likes + Comments)/ Followers*",
                    "minimum": 0
                  },
                  "likesPerFollower": {
                    "type": "number",
                    "description": "Average number of likes per follower, rounded to 4th decimal place.",
                    "minimum": 0
                  },
                  "commentsPerFollower": {
                    "type": "number",
                    "description": "Average number of comments per follower, rounded to 4th decimal place.",
                    "minimum": 0
                  },
                  "engagementConsistency": {
                    "type": "object",
                    "description": "Consistency of engagement performance.",
                    "properties": {
                      "cv": {
                        "type": "number",
                        "description": "*cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />\n- The value is rounded to 4th decimal place. <br />\n- Lower values indicate more consistent performance. <br />\n- *A value of `0` indicates insufficient data.*",
                        "minimum": 0
                      },
                      "medianVsMean": {
                        "type": "number",
                        "description": "*medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />\n- The value is rounded to 4th decimal place. <br />\n- Values closer to `1` indicate more consistent performance. <br />\n- *A value of `0` indicates insufficient data.*",
                        "minimum": 0
                      },
                      "topBottomRatio": {
                        "type": "number",
                        "description": "*topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />\n- The value is rounded to 4th decimal place. <br />\n- Lower ratios indicate more consistent performance. <br />\n- *A value of `0` indicates insufficient data.*",
                        "minimum": 0
                      },
                      "consistencyScore": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "*consistencyScore &#61; 100 - [(cvScore\\*weight_cv) + (topBottomScore\\*weight_topBottom) + (medianVsMeanScore\\*weight_medianVsMean)]* <br />\n- The score is rounded to an integer. <br />\n- A higher score indicates more stable and consistent performance. <br />\n- Returns `null` when any of the three indicators (`cv`, `medianVsMean`, `topBottomRatio`) is `0`, indicating insufficient data.",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "consistencyLevel": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "enum": [
                          "high",
                          "moderate",
                          "low",
                          null
                        ],
                        "description": "A qualitative label based on the `consistencyScore`: <br />\n- high: 81 - 100 <br />\n- moderate: 51 - 80 <br />\n- low: 1 - 50 <br />\n- Returns `null` when `consistencyScore` is `null`, indicating insufficient data."
                      }
                    },
                    "required": [
                      "cv",
                      "medianVsMean",
                      "topBottomRatio",
                      "consistencyScore",
                      "consistencyLevel"
                    ]
                  }
                },
                "required": [
                  "avgEngagementRate",
                  "likesPerFollower",
                  "commentsPerFollower",
                  "engagementConsistency"
                ]
              }
            },
            "required": [
              "likes",
              "comments",
              "engagement"
            ]
          },
          "reelsPerformanceRecent": {
            "type": "object",
            "description": "The Instagram reels performance metrics for the specified time period.",
            "properties": {
              "likes": {
                "type": "object",
                "properties": {
                  "all": {
                    "type": "integer",
                    "description": "Total number of likes.",
                    "minimum": 0
                  },
                  "avg": {
                    "type": "number",
                    "description": "Average number of likes per Instagram reel, rounded to an integer.",
                    "minimum": 0
                  },
                  "median": {
                    "type": "number",
                    "description": "Median number of likes.",
                    "minimum": 0
                  },
                  "min": {
                    "type": "number",
                    "description": "Minimum number of likes.",
                    "minimum": 0
                  },
                  "max": {
                    "type": "number",
                    "description": "Maximum number of likes.",
                    "minimum": 0
                  }
                },
                "required": [
                  "all",
                  "avg",
                  "median",
                  "min",
                  "max"
                ]
              },
              "comments": {
                "type": "object",
                "properties": {
                  "all": {
                    "type": "integer",
                    "description": "Total number of comments.",
                    "minimum": 0
                  },
                  "avg": {
                    "type": "number",
                    "description": "Average number of comments per Instagram reel, rounded to an integer.",
                    "minimum": 0
                  },
                  "median": {
                    "type": "number",
                    "description": "Median number of comments.",
                    "minimum": 0
                  },
                  "min": {
                    "type": "number",
                    "description": "Minimum number of comments.",
                    "minimum": 0
                  },
                  "max": {
                    "type": "number",
                    "description": "Maximum number of comments.",
                    "minimum": 0
                  }
                },
                "required": [
                  "all",
                  "avg",
                  "median",
                  "min",
                  "max"
                ]
              },
              "views": {
                "type": "object",
                "properties": {
                  "all": {
                    "type": "integer",
                    "description": "Total number of views.",
                    "minimum": 0
                  },
                  "avg": {
                    "type": "number",
                    "description": "Average number of views per Instagram reel, rounded to an integer.",
                    "minimum": 0
                  },
                  "median": {
                    "type": "number",
                    "description": "Median number of views.",
                    "minimum": 0
                  },
                  "min": {
                    "type": "number",
                    "description": "Minimum number of views.",
                    "minimum": 0
                  },
                  "max": {
                    "type": "number",
                    "description": "Maximum number of views.",
                    "minimum": 0
                  }
                },
                "required": [
                  "all",
                  "avg",
                  "median",
                  "min",
                  "max"
                ]
              },
              "engagement": {
                "type": "object",
                "description": "Engagement performance metrics for Instagram reels.",
                "properties": {
                  "avgEngagementRate": {
                    "type": "number",
                    "description": "Average engagement rate per Instagram reel (excluding older pinned reels), rounded to 4th decimal place. <br />\n  - *Engagement Rate &#61; (Likes + Comments) / Views*",
                    "minimum": 0
                  },
                  "likesPerFollower": {
                    "type": "number",
                    "description": "Average number of likes per follower, rounded to 4th decimal place.",
                    "minimum": 0
                  },
                  "commentsPerFollower": {
                    "type": "number",
                    "description": "Average number of comments per follower, rounded to 4th decimal place.",
                    "minimum": 0
                  },
                  "viewsPerFollower": {
                    "type": "number",
                    "description": "Average number of views per follower, rounded to 4th decimal place.",
                    "minimum": 0
                  },
                  "engagementConsistency": {
                    "type": "object",
                    "description": "Consistency of engagement performance across Instagram reels.",
                    "properties": {
                      "cv": {
                        "type": "number",
                        "description": "*cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />\n- The value is rounded to 4th decimal place. <br />\n- Lower values indicate more consistent performance. <br />\n- *A value of `0` indicates insufficient data.*",
                        "minimum": 0
                      },
                      "medianVsMean": {
                        "type": "number",
                        "description": "*medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />\n- The value is rounded to 4th decimal place. <br />\n- Values closer to `1` indicate more consistent performance. <br />\n- *A value of `0` indicates insufficient data.*",
                        "minimum": 0
                      },
                      "topBottomRatio": {
                        "type": "number",
                        "description": "*topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />\n- The value is rounded to 4th decimal place. <br />\n- Lower ratios indicate more consistent performance. <br />\n- *A value of `0` indicates insufficient data.*",
                        "minimum": 0
                      },
                      "consistencyScore": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "*consistencyScore &#61; 100 - [(cvScore\\*weight_cv) + (topBottomScore\\*weight_topBottom) + (medianVsMeanScore\\*weight_medianVsMean)]* <br />\n- The score is rounded to an integer. <br />\n- A higher score indicates more stable and consistent performance. <br />\n- Returns `null` when any of the three indicators (`cv`, `medianVsMean`, `topBottomRatio`) is `0`, indicating insufficient data.",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "consistencyLevel": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "enum": [
                          "high",
                          "moderate",
                          "low",
                          null
                        ],
                        "description": "A qualitative label based on the `consistencyScore`: <br />\n- high: 81 - 100 <br />\n- moderate: 51 - 80 <br />\n- low: 1 - 50 <br />\n- Returns `null` when `consistencyScore` is `null`, indicating insufficient data."
                      }
                    },
                    "required": [
                      "cv",
                      "medianVsMean",
                      "topBottomRatio",
                      "consistencyScore",
                      "consistencyLevel"
                    ]
                  }
                },
                "required": [
                  "avgEngagementRate",
                  "likesPerFollower",
                  "commentsPerFollower",
                  "viewsPerFollower",
                  "engagementConsistency"
                ]
              }
            },
            "required": [
              "likes",
              "comments",
              "views",
              "engagement"
            ]
          }
        },
        "required": [
          "timestamp",
          "totalFollowers",
          "totalFollowing",
          "totalContents",
          "imagesPerformanceRecent",
          "reelsPerformanceRecent"
        ]
      }
    }
  },
  "required": [
    "histories"
  ]
}

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/creatordb-app-instagram-performance-history-data"
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.