{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/panorama/creator-vetting.json","title":"panorama/creator-vetting 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":{"post_evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Original post id."},"url":{"type":["string","null"],"description":"Original post link."},"counts":{"type":"object","properties":{"likes":{"type":["number","null"],"description":"Likes."},"comments":{"type":["number","null"],"description":"Comments."},"shares":{"type":["number","null"],"description":"Shares."},"views":{"type":["number","null"],"description":"Views."}},"additionalProperties":true},"interactions":{"type":["number","null"],"description":"Observed likes+comments+shares; views separate."},"counters_reported":{"type":["number","null"],"description":"Known interaction counters."},"view_engagement_rate":{"type":["number","null"],"description":"Observed interactions/views, fraction; null with missing or zero views."},"created_at":{"type":["string","null"],"description":"Original publication timestamp."},"count_sources":{"type":"object","properties":{"likes":{"type":["object","null"],"properties":{"endpoint":{"type":["string","null"],"description":"Qualified source endpoint."},"id":{"type":["string","null"],"description":"Native post id matched exactly."},"field":{"type":["string","null"],"description":"Field path in that endpoint’s normalized response."}},"additionalProperties":true},"comments":{"type":["object","null"],"properties":{"endpoint":{"type":["string","null"],"description":"Qualified source endpoint."},"id":{"type":["string","null"],"description":"Native post id matched exactly."},"field":{"type":["string","null"],"description":"Field path in that endpoint’s normalized response."}},"additionalProperties":true},"shares":{"type":["object","null"],"properties":{"endpoint":{"type":["string","null"],"description":"Qualified source endpoint."},"id":{"type":["string","null"],"description":"Native post id matched exactly."},"field":{"type":["string","null"],"description":"Field path in that endpoint’s normalized response."}},"additionalProperties":true},"views":{"type":["object","null"],"properties":{"endpoint":{"type":["string","null"],"description":"Qualified source endpoint."},"id":{"type":["string","null"],"description":"Native post id matched exactly."},"field":{"type":["string","null"],"description":"Field path in that endpoint’s normalized response."}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true}},"sample":{"type":"object","properties":{"posts_limit":{"type":["number","null"],"description":"Requested maximum posts, integer1–20."},"comment_posts_requested":{"type":["number","null"],"description":"Requested maximum posts to sample for comments, integer0–10."},"comment_posts_attempted":{"type":["number","null"],"description":"Posts selected for comment requests; inspect source receipts for dispatch or budget refusals."},"comment_posts_completed":{"type":["number","null"],"description":"Selected posts whose comment lookup returned data."},"comments_per_post":{"type":["number","null"],"description":"Maximum retained comments from each selected post, integer1–50."},"comments_returned":{"type":["number","null"],"description":"Retained nonempty comment records after native ID deduplication per post."},"selection":{"type":["string","null"],"description":"Highest reported interaction counts within the returned recent-post page."},"exhaustive":{"type":["boolean","null"],"description":"False: bounded samples are not an audience census."}},"additionalProperties":true},"_meta":{"type":"object","properties":{"methodology_version":{"type":["string","null"],"description":"creator-vetting-v3."}},"additionalProperties":true},"output":{"type":"object","properties":{"posts_sampled":{"type":["number","null"],"description":"Number of posts retained from the returned recent-post page."},"posts_with_engagement":{"type":["number","null"],"description":"Returned posts with observed interaction inputs, including legitimate zeros."},"posts_missing_engagement":{"type":["number","null"],"description":"Posts with no usable interaction inputs."},"avg_engagement_per_post":{"type":["number","null"],"description":"Rounded mean of reported interactions over posts with at least one known counter, including zeros."},"engagement_rate":{"type":["number","null"],"description":"avg_engagement_per_post divided by followers; fraction, null without a usable denominator."},"posting_cadence_days":{"type":["number","null"],"description":"Mean gap in UTC days between consecutive dated sampled posts; null with fewer than two dates."},"follower_denominator":{"type":["number","null"],"description":"Published follower/subscriber denominator; null when unavailable or hidden."},"follower_source_field":{"type":["string","null"],"description":"followers, followers_count or subscribers; null when unknown."}},"additionalProperties":true},"comment_sample":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Native comment id."},"text":{"type":["string","null"],"description":"Original nonempty comment text."},"likes":{"type":["number","null"],"description":"Original like count or null."},"author":{"type":["object","string","null"],"additionalProperties":true},"url":{"type":["string","null"],"description":"Original comment URL or null."},"post_id":{"type":["string","null"],"description":"Parent post native id."},"post_url":{"type":["string","null"],"description":"Parent post URL."},"created_at":{"type":["string","null"],"description":"Original comment timestamp or null."}},"additionalProperties":true}},"metrics_hydration":{"type":"object","properties":{"status":{"type":["string","null"],"description":"not_needed, complete, partial or unavailable. Complete means all requested hydration rows have views, likes and comment counts."},"endpoint":{"type":["string","null"],"description":"youtube/videos for YouTube; otherwise null."},"requested":{"type":["number","null"],"description":"Unique video IDs requested, at most10."},"returned":{"type":["number","null"],"description":"Identity-matched returned rows, even if some counters are unpublished."},"cap":{"type":["number","null"],"description":"10."},"missing_ids":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"content_review":{"type":"object","properties":{"version":{"type":["string","null"],"description":"creator-post-text-review-v1."},"status":{"type":["string","null"],"description":"complete, partial, unavailable or no_candidates."},"scope":{"type":["string","null"],"description":"returned_post_text_only."},"posts_returned":{"type":["number","null"],"description":"Retained original posts, at most20."},"posts_selected":{"type":["number","null"],"description":"At most8 evenly spaced posts."},"posts_examined":{"type":["number","null"],"description":"Posts with complete or partial model output."},"posts_completed":{"type":["number","null"],"description":"Posts whose full criteria set was answered, including uncertainty."},"remaining_unclassified":{"type":["number","null"],"description":"Unselected, unavailable or incomplete posts."},"source_posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","number","null"]},"url":{"type":["string","null"],"description":"Original link."},"title":{"type":["string","null"],"description":"Original title."},"text":{"type":["string","null"],"description":"Original text."},"caption":{"type":["string","null"],"description":"Original caption."}},"additionalProperties":true}},"flags":{"type":"array","items":{"type":"object","properties":{"native_id":{"type":["string","number","null"]},"path":{"type":"array","items":{"type":["string","number"]}},"url":{"type":["string","null"],"description":"Original link."},"category":{"type":"string","enum":["authored_threat","targeted_abuse","explicit_sexual_text","regulated_product_promotion","sponsorship","engagement_bait","prompt_injection"]},"support":{"type":["number","null"],"description":"Model support, not calibrated accuracy."},"evidence":{"type":"array","items":{"type":"object","properties":{"sentence_index":{"type":["number","null"],"description":"Zero-based sentence index in the bounded classifier input."},"field":{"type":["string","null"],"description":"Original returned text field."},"start":{"type":["number","null"],"description":"Inclusive UTF-16 offset in that field."},"end":{"type":["number","null"],"description":"Exclusive UTF-16 offset."},"text":{"type":["string","null"],"description":"Exact original substring; never generated supporting prose."}},"additionalProperties":true}},"requires_human_review":{"type":["boolean","null"],"description":"True."}},"additionalProperties":true}},"assessments":{"type":"array","items":{"type":"object","properties":{"native_id":{"type":["string","number","null"]},"path":{"type":"array","items":{"type":["string","number"]}},"url":{"type":["string","null"],"description":"Original link."},"status":{"type":["string","null"],"description":"Complete, partial or unavailable annotation."},"scope":{"type":["string","null"],"description":"Returned text scope."},"judgments":{"type":"object","additionalProperties":{"type":"object","properties":{"label":{"type":["string","null"],"description":"Selected label, or uncertain when support/evidence is insufficient."},"status":{"type":["string","null"],"description":"classified, uncertain or unavailable."},"support":{"type":["number","null"],"description":"Model support0–1; not calibrated accuracy."},"evidence":{"type":"array","items":{"type":"object","properties":{"sentence_index":{"type":["number","null"],"description":"Zero-based sentence index in the bounded classifier input."},"field":{"type":["string","null"],"description":"Original returned text field."},"start":{"type":["number","null"],"description":"Inclusive UTF-16 offset in that field."},"end":{"type":["number","null"],"description":"Exclusive UTF-16 offset."},"text":{"type":["string","null"],"description":"Exact original substring; never generated supporting prose."}},"additionalProperties":true}},"reason":{"type":["string","null"],"description":"Reason for uncertain/unavailable analysis."}},"additionalProperties":true}}},"additionalProperties":true}},"breakdown":{"type":["object","null"],"additionalProperties":true},"requires_human_review":{"type":["boolean","null"],"description":"True."},"images_and_video_analyzed":{"type":["boolean","null"],"description":"False."},"interpretation":{"type":["string","null"],"description":"Text sample limits; no creator identity, authenticity or suitability judgment."}},"additionalProperties":true},"analysis_legs":{"type":"array","items":{"type":"object","properties":{"source":{"type":["string","null"],"description":"intelligence:jev."},"ok":{"type":["boolean","null"],"description":"Model request completed."},"skipped":{"type":["boolean","null"],"description":"No model dispatch occurred."},"cost_micros":{"type":["number","null"],"description":"Known supplier cost in micro-GBP; inspect pending_cost before interpreting zero."},"cost_confirmed":{"type":["boolean","null"],"description":"A measured receipt exists."},"pending_cost":{"type":["boolean","null"],"description":"Dispatch had no final measured receipt; quoted allowance remains held."},"funding_reason":{"type":["string","null"],"description":"Admission limit that prevented dispatch."}},"additionalProperties":true}}},"additionalProperties":true,"examples":[{"output":{"posts_sampled":1,"posts_with_engagement":1,"posts_missing_engagement":0,"avg_engagement_per_post":0,"engagement_rate":0,"posting_cadence_days":null,"follower_denominator":100,"follower_source_field":"followers"},"post_evidence":[{"id":"example-post","url":null,"counts":{"likes":0,"comments":0,"shares":null,"views":100},"interactions":0,"counters_reported":2,"view_engagement_rate":0,"created_at":null,"count_sources":{"likes":{"endpoint":"instagram/posts","id":"example-post","field":"stats.likes"},"comments":{"endpoint":"instagram/posts","id":"example-post","field":"stats.comments"},"shares":null,"views":{"endpoint":"instagram/posts","id":"example-post","field":"stats.views"}}}],"comment_sample":[],"sample":{"posts_limit":20,"comment_posts_requested":0,"comment_posts_attempted":0,"comment_posts_completed":0,"comments_per_post":20,"comments_returned":0,"selection":"highest reported interaction counts within the returned recent-post page","exhaustive":false},"_meta":{"methodology_version":"creator-vetting-v3"},"metrics_hydration":{"status":"not_needed","endpoint":null,"requested":0,"returned":0,"cap":10,"missing_ids":[]}}]}