{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/instagram/engagement.json","title":"instagram/engagement data fields","description":"Documented optional core fields of data. Additional source fields are allowed. This is not the response envelope or a guarantee of availability or completeness.","type":"object","properties":{"profile":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Source identifier. Preserve its exact string value; do not convert large IDs to numbers."},"handle":{"type":["string","null"],"description":"Public account username."},"name":{"type":["string","null"],"description":"Display name."},"url":{"type":["string","null"],"description":"Original source URL when supplied."},"bio":{"type":["string","null"],"description":"Public biography."},"bio_link":{"type":["string","null"],"description":"Original source URL when supplied."},"avatar_url":{"type":["string","null"],"description":"Original source URL when supplied."},"followers":{"type":["number","null"],"description":"Followers reported by the source; null or absent is unknown, not zero."},"following":{"type":["number","null"],"description":"Following reported by the source; null or absent is unknown, not zero."},"verified":{"type":["boolean","null"],"description":"Source verification flag; meaning depends on the platform."},"posts_count":{"type":["number","null"],"description":"Posts reported by the source; null or absent is unknown, not zero."},"business":{"type":["boolean","null"],"description":"Business-account flag."},"private":{"type":["boolean","null"],"description":"Account privacy flag."}},"additionalProperties":true},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Source identifier. Preserve its exact string value; do not convert large IDs to numbers."},"url":{"type":["string","null"],"description":"Original source URL when supplied."},"caption":{"type":["string","null"],"description":"Post caption."},"created_at":{"type":["string","null"],"description":"Source publication time, normalized to an ISO date-time when available."},"author":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Source identifier. Preserve its exact string value; do not convert large IDs to numbers."},"handle":{"type":["string","null"],"description":"Public account username."},"name":{"type":["string","null"],"description":"Display name."},"url":{"type":["string","null"],"description":"Original source URL when supplied."}},"additionalProperties":true},"stats":{"type":"object","properties":{"likes":{"type":["number","null"],"description":"likes reported by the source; null or absent is unknown, not zero."},"comments":{"type":["number","null"],"description":"comments reported by the source; null or absent is unknown, not zero."},"plays":{"type":["number","null"],"description":"plays reported by the source; null or absent is unknown, not zero."},"shares":{"type":["number","null"],"description":"shares reported by the source; null or absent is unknown, not zero."},"saves":{"type":["number","null"],"description":"saves reported by the source; null or absent is unknown, not zero."}},"additionalProperties":true}},"additionalProperties":true}},"computed":{"type":"object","properties":{"followers":{"type":["number","null"],"description":"Current followers reported by the source; null or absent is unknown, not zero."},"posts_observed":{"type":["number","null"],"description":"Observed posts reported by the source; null or absent is unknown, not zero."},"posts_with_both_metrics":{"type":["number","null"],"description":"Posts with both likes and comments reported by the source; null or absent is unknown, not zero."},"average_interactions":{"type":["number","null"],"description":"Mean likes + comments over usable pairs."},"engagement_rate_percent":{"type":["number","null"],"description":"100 × average_interactions / followers; null for missing or zero followers, or no usable pair."}},"additionalProperties":true},"partial":{"type":["boolean","null"],"description":"Whether collection was partial."},"complete":{"type":["boolean","null"],"description":"Source completion flag; this operation is a bounded sample."},"_warnings":{"type":"array","items":{"type":"string"},"description":"Collection limitations or component warnings. Read before interpreting coverage."}},"additionalProperties":true,"examples":[{"computed":{"followers":1200,"posts_observed":3,"posts_with_both_metrics":2,"average_interactions":24,"engagement_rate_percent":2}}]}