{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/tiktok_ads/ad.json","title":"tiktok_ads/ad data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"account":{"description":"Optional account supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"followers":{"type":["number","string","null"],"description":"Reported followers. Abbreviations such as 6.7M become numeric estimates; inspect followers_estimated and followers_text. Unknown non-numeric labels may remain text."},"handle":{"description":"Optional handle supplied by this operation. Null means unknown.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"followers_text":{"type":["string","null"],"description":"Original abbreviated follower count when converted."},"followers_estimated":{"type":["boolean","null"],"description":"True when the numeric count was expanded from a rounded abbreviation."}},"additionalProperties":true},"advertiser":{"description":"Optional advertiser supplied by this operation. Null means unknown.","type":["string","null"]},"engagement":{"description":"Optional engagement supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"favorites":{"description":"Optional favorites supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"first_shown":{"description":"Optional first shown supplied by this operation. Null means unknown.","type":["string","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"is_unavailable":{"description":"Optional is unavailable supplied by this operation. Null means unknown.","type":["boolean","null"]},"keywords":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"landing_page":{"description":"Optional landing page supplied by this operation. Null means unknown.","type":["string","null"]},"last_shown":{"description":"Optional last shown supplied by this operation. Null means unknown.","type":["string","null"]},"objective":{"description":"Optional objective supplied by this operation. Null means unknown.","type":["string","null"]},"platform":{"description":"Optional platform supplied by this operation. Null means unknown.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"video":{"description":"Optional video supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"cover":{"description":"Optional cover supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["account"],"properties":{"account":{"description":"Optional account supplied by this operation. Null means unknown.","type":["object"],"properties":{"followers":{"type":["number","string","null"],"description":"Reported followers. Abbreviations such as 6.7M become numeric estimates; inspect followers_estimated and followers_text. Unknown non-numeric labels may remain text."},"handle":{"description":"Optional handle supplied by this operation. Null means unknown.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"followers_text":{"type":["string","null"],"description":"Original abbreviated follower count when converted."},"followers_estimated":{"type":["boolean","null"],"description":"True when the numeric count was expanded from a rounded abbreviation."}},"additionalProperties":true}}},{"required":["advertiser"],"properties":{"advertiser":{"description":"Optional advertiser supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["engagement"],"properties":{"engagement":{"description":"Optional engagement supplied by this operation. Null means unknown.","type":["object"],"properties":{"favorites":{"description":"Optional favorites supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["first_shown"],"properties":{"first_shown":{"description":"Optional first shown supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["is_unavailable"],"properties":{"is_unavailable":{"description":"Optional is unavailable supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["keywords"],"properties":{"keywords":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"required":["landing_page"],"properties":{"landing_page":{"description":"Optional landing page supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["last_shown"],"properties":{"last_shown":{"description":"Optional last shown supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["objective"],"properties":{"objective":{"description":"Optional objective supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["title"],"properties":{"title":{"description":"Source title when supplied.","type":["string"],"minLength":1}}},{"required":["video"],"properties":{"video":{"description":"Optional video supplied by this operation. Null means unknown.","type":["object"],"properties":{"cover":{"description":"Optional cover supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"account":{"followers":"example","handle":"example","name":"example","url":"https://example.com/example"},"advertiser":"example","engagement":{"favorites":0},"first_shown":"example","id":"example","is_unavailable":false,"keywords":[],"landing_page":"example","last_shown":"example","objective":"example","platform":"example","title":"example","video":{"cover":"example"}}]}