{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/twitch/clip.json","title":"twitch/clip data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"broadcaster":{"description":"Optional broadcaster supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true},"created_at":{"description":"Source creation time, not the API retrieval time.","type":["string","null"]},"creator":{"description":"Optional creator supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true},"duration_seconds":{"description":"Optional duration seconds supplied by this operation. Null means unknown.","type":["number","null"]},"embed_url":{"description":"Optional embed url supplied by this operation. Null means unknown.","type":["string","null"]},"game_id":{"description":"Optional game id 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_featured":{"description":"Optional is featured supplied by this operation. Null means unknown.","type":["boolean","null"]},"language":{"description":"Optional language supplied by this operation. Null means unknown.","type":["string","null"]},"thumbnail_url":{"description":"Optional thumbnail url supplied by this operation. Null means unknown.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"view_count":{"description":"Optional view count supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["broadcaster"],"properties":{"broadcaster":{"description":"Optional broadcaster supplied by this operation. Null means unknown.","type":["object"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}},{"required":["created_at"],"properties":{"created_at":{"description":"Source creation time, not the API retrieval time.","type":["string"],"minLength":1}}},{"required":["creator"],"properties":{"creator":{"description":"Optional creator supplied by this operation. Null means unknown.","type":["object"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}},{"required":["duration_seconds"],"properties":{"duration_seconds":{"description":"Optional duration seconds supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["embed_url"],"properties":{"embed_url":{"description":"Optional embed url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["game_id"],"properties":{"game_id":{"description":"Optional game id 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_featured"],"properties":{"is_featured":{"description":"Optional is featured supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["language"],"properties":{"language":{"description":"Optional language supplied by this operation. Null means unknown.","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":["title"],"properties":{"title":{"description":"Source title when supplied.","type":["string"],"minLength":1}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}},{"required":["view_count"],"properties":{"view_count":{"description":"Optional view count supplied by this operation. Null means unknown.","type":["number"]}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"broadcaster":{"id":"example","name":"example"},"created_at":"2026-09-01T12:00:00Z","creator":{"id":"example","name":"example"},"duration_seconds":0,"embed_url":"https://example.com/example","game_id":"example","id":"example","is_featured":false,"language":"example","thumbnail_url":"https://example.com/example","title":"example","url":"https://example.com/example","view_count":0}]}