{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/tiktok/profile/full.json","title":"tiktok/profile/full 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."},"likes_count":{"type":["number","null"],"description":"Account likes reported by the source; null or absent is unknown, not zero."},"video_count":{"type":["number","null"],"description":"Videos reported by the source; null or absent is unknown, not zero."},"commerce_user":{"type":["boolean","null"],"description":"Commerce-account flag; not a business category."},"seller":{"type":["boolean","null"],"description":"Seller flag."},"region":{"type":["string","null"],"description":"Account region supplied by TikTok; not personal residence."},"business_category":{"type":["string","null"],"description":"Public source category."}},"additionalProperties":true},"posts":{"type":["array","null"],"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":"Video caption; spoken words require a transcript request."},"created_at":{"type":["string","null"],"description":"Source publication time, normalized to an ISO date-time when available."},"duration_s":{"type":["number","null"],"description":"Video duration in seconds."},"region":{"type":["string","null"],"description":"Source-reported content region, not audience geography or proof of residence."},"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."},"followers":{"type":["number","null"],"description":"Follower count supplied with this video; null when absent. No profile-enrichment call is made."},"region":{"type":["string","null"],"description":"Source-reported account region, not audience geography or proof of residence."}},"additionalProperties":true},"stats":{"type":"object","properties":{"plays":{"type":["number","null"],"description":"plays reported by the source; null or absent is unknown, not zero."},"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."},"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","null"],"properties":{"sample_size":{"type":["number","null"],"description":"Returned rows reported by the source; null or absent is unknown, not zero."},"metric_samples":{"type":"object","properties":{"likes":{"type":["number","null"],"description":"Number of usable numeric observations for likes; each metric uses its own available sample."},"comments":{"type":["number","null"],"description":"Number of usable numeric observations for comments; each metric uses its own available sample."},"shares":{"type":["number","null"],"description":"Number of usable numeric observations for shares; each metric uses its own available sample."},"views":{"type":["number","null"],"description":"Number of usable numeric observations for views; each metric uses its own available sample."}},"additionalProperties":true},"averages":{"type":"object","properties":{"likes":{"type":["number","null"],"description":"Arithmetic mean for likes; each metric uses its own available sample."},"comments":{"type":["number","null"],"description":"Arithmetic mean for comments; each metric uses its own available sample."},"shares":{"type":["number","null"],"description":"Arithmetic mean for shares; each metric uses its own available sample."},"views":{"type":["number","null"],"description":"Arithmetic mean for views; each metric uses its own available sample."}},"additionalProperties":true},"posting_window":{"type":"object","properties":{"posts_with_timestamps":{"type":["number","null"],"description":"Rows with usable timestamps reported by the source; null or absent is unknown, not zero."},"start":{"type":["string","null"],"description":"Source publication time, normalized to an ISO date-time when available."},"end":{"type":["string","null"],"description":"Source publication time, normalized to an ISO date-time when available."},"days":{"type":["number","null"],"description":"Elapsed days between earliest and latest valid timestamps; null with fewer than two dates."}},"additionalProperties":true},"observed_posts_per_day":{"type":["number","null"],"description":"(posts_with_timestamps - 1) / days; null unless days is positive. This describes the returned page only."}},"additionalProperties":true},"complete":{"type":["boolean","null"],"description":"All requested components succeeded; not a full-history guarantee."},"partial":{"type":["boolean","null"],"description":"One or more requested components failed."},"legs":{"type":"array","items":{"type":"object","properties":{"component":{"type":["string","null"],"description":"Component name."},"endpoint":{"type":["string","null"],"description":"Component route."},"ok":{"type":["boolean","null"],"description":"Whether usable component data was returned."},"status":{"type":["number","null"],"description":"Component HTTP status."},"credits":{"type":["number","null"],"description":"Confirmed component charge."},"error":{"type":["string","null"],"description":"Public component failure description."}},"additionalProperties":true}},"posts_cursor":{"type":["string","null"],"description":"Returned posts continuation, if available."},"posts_pagination":{"type":"object","properties":{"requested":{"type":["number","null"],"description":"Desired rows reported by the source; null or absent is unknown, not zero."},"returned":{"type":["number","null"],"description":"Returned rows reported by the source; null or absent is unknown, not zero."},"total":{"type":["number","null"],"description":"Source total reported by the source; null or absent is unknown, not zero."},"has_more":{"type":["boolean","null"],"description":"Source continuation indicator."},"next_params":{"type":["object","null"],"properties":{"handle":{"type":["string","null"],"description":"Account handle."},"cursor":{"type":["string","null"],"description":"Opaque cursor; pass every supplied next parameter together."}},"additionalProperties":true}},"additionalProperties":true},"_warnings":{"type":"array","items":{"type":"string"},"description":"Collection limitations or component warnings. Read before interpreting coverage."}},"additionalProperties":true,"examples":[{"profile":{"id":"7350000000000000001","handle":"example_creator","name":"Example Creator","followers":12000,"following":180,"bio":null,"verified":false},"posts":[{"id":"7350000000000000002","url":"https://www.tiktok.com/@example_creator/video/7350000000000000002","caption":"A desk setup","created_at":"2026-09-01T12:00:00.000Z","duration_s":15,"stats":{"plays":1200,"likes":100,"comments":12,"shares":null,"saves":8}}],"complete":true,"partial":false,"posts_cursor":null,"posts_pagination":{"returned":1,"has_more":null,"next_params":null}}]}