{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/tiktok/ads-top.json","title":"tiktok/ads-top data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"_warnings":{"description":"Optional  warnings supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"country":{"description":"Optional country supplied by this operation. Null means unknown.","type":["string","null"]},"has_more":{"description":"Source continuation indicator; null means unknown.","type":["boolean","null"]},"items":{"description":"Returned records. Source coverage and completeness vary.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":"object","properties":{"brand_name":{"description":"Optional brand name supplied by this operation. Null means unknown.","type":["string","null"]},"cost_bucket":{"description":"Optional cost bucket supplied by this operation. Null means unknown.","type":["number","null"]},"ctr":{"description":"Optional ctr supplied by this operation. Null means unknown.","type":["number","null"]},"duration_seconds":{"description":"Optional duration seconds supplied by this operation. Null means unknown.","type":["number","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"industry_key":{"description":"Optional industry key supplied by this operation. Null means unknown.","type":["string","null"]},"likes":{"description":"Optional likes supplied by this operation. Null means unknown.","type":["number","null"]},"objective_key":{"description":"Optional objective key supplied by this operation. Null means unknown.","type":["string","null"]},"platform":{"description":"Optional platform supplied by this operation. Null means unknown.","type":["string","null"]},"text":{"description":"Source text when supplied.","type":["string","null"]},"thumbnail_url":{"description":"Optional thumbnail url supplied by this operation. Null means unknown.","type":["string","null"]},"video_urls":{"description":"Optional video urls supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["brand_name"],"properties":{"brand_name":{"description":"Optional brand name supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["cost_bucket"],"properties":{"cost_bucket":{"description":"Optional cost bucket supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["ctr"],"properties":{"ctr":{"description":"Optional ctr supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["duration_seconds"],"properties":{"duration_seconds":{"description":"Optional duration seconds supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["industry_key"],"properties":{"industry_key":{"description":"Optional industry key supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["likes"],"properties":{"likes":{"description":"Optional likes supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["objective_key"],"properties":{"objective_key":{"description":"Optional objective key supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["text"],"properties":{"text":{"description":"Source text when supplied.","type":["string"],"minLength":1}}},{"required":["thumbnail_url"],"properties":{"thumbnail_url":{"description":"Optional thumbnail url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["video_urls"],"properties":{"video_urls":{"description":"Optional video urls supplied by this operation. Null means unknown.","type":["object"],"properties":{},"additionalProperties":true}}}]}]}},"next_page":{"description":"Optional next page supplied by this operation. Null means unknown.","type":["number","null"]},"page":{"description":"Optional page supplied by this operation. Null means unknown.","type":["number","null"]},"period":{"description":"Optional period supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true,"required":["items"],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"_warnings":["example"],"count":0,"country":"example","has_more":false,"items":[{"brand_name":"example","cost_bucket":0,"ctr":0,"duration_seconds":0,"id":"example","industry_key":"example","likes":0,"objective_key":"example","platform":"example","text":"example","thumbnail_url":"https://example.com/example","video_urls":{}}],"next_page":0,"page":0,"period":0}]}