# Creator - Video List V2 ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/item_creator/v2/videos: get: summary: Creator - Video List V2 deprecated: false description: >- Creator video list V2. The publish-date filter is converted from the timezone of x-selected-lng back to UTC+8 before querying. zh-CN does not shift the filter. Returned times are epoch milliseconds and are not shifted. Language values come from GET /api/meta/language. tags: - Data APIs/Item Creator parameters: - name: authorUid in: query description: '' required: true example: '' schema: type: string - name: sortField in: query description: Sort the query results by which field (descending order) required: true example: '' schema: type: string - name: tkCategoryId in: query description: Tiktok category ID required: false example: '' schema: type: string - name: itemVideoFlag in: query description: Do you only watch sales videos? 1- Yes, 0- No required: false example: 0 schema: type: integer - name: pageNo in: query description: Default 1 required: false example: 0 schema: type: integer - name: pageSize in: query description: Default 10 required: false example: 0 schema: type: integer - name: materialCreateBeginDs in: query description: 'Start date, format yyyyMMdd, for example: 20241122' required: true example: '' schema: type: string - name: materialCreateEndDs in: query description: ' date, format yyyyMMdd, for example: 20251123' required: true schema: type: string - name: x-appKey in: header description: '' required: true example: '{{appKey}}' schema: type: string - name: x-timestamp in: header description: '' required: true example: '{{x-timestamp}}' schema: type: string - name: x-sign in: header description: '' required: true example: '{{x-sign}}' schema: type: string - name: x-selected-lng in: header description: >- Category language and timezone. The tkCategoryId query parameter is converted using this language. The publish-date filter is converted from this timezone back to UTC+8 before querying. Returned times are epoch milliseconds and are not shifted. zh-CN does not shift the filter. Values: zh-CN, en, id-ID, ms-MY, fil-PH, th-TH, vi-VN, ja-JP. See GET /api/meta/language. required: false example: ja-JP schema: type: string enum: - zh-CN - en - id-ID - ms-MY - fil-PH - th-TH - vi-VN - ja-JP responses: '200': description: '' content: application/json: schema: type: object properties: code: type: string message: type: string result: type: object properties: total: type: integer pageNo: type: integer pageSize: type: integer data: type: array items: type: object properties: videoId: type: string videoCoverUrl: type: string videoUrl: type: string videoDesc: type: string videoDuration: type: integer discoverTime: type: integer createTime: description: Release Time type: integer updateTime: type: integer creatorUid: type: string region: type: string playCountInfo: type: object properties: total: type: integer required: - total description: Play Count x-apifox-orders: - total likeCountInfo: type: object properties: total: type: integer required: - total x-apifox-orders: - total shareCountInfo: type: object properties: total: type: integer required: - total x-apifox-orders: - total commentCountInfo: type: object properties: total: type: integer required: - total x-apifox-orders: - total soldCountInfo: type: object properties: video: type: integer required: - video description: Sales Volume of Goods Promoted in the Video x-apifox-orders: - video currencySymbolInfo: type: object properties: local: type: string title: Local currency symbol region: type: string title: USD symbol required: - local - region x-apifox-orders: - local - region gmvInfo: type: object properties: video: type: object properties: local: type: number title: Local currency amount region: type: number title: USD amount required: - local - region x-apifox-orders: - local - region required: - video x-apifox-orders: - video engageRate: description: Interaction Rate type: number adAwemeSource: type: string nullable: true itemId: type: string itemName: type: string itemPicUrl: type: array items: type: string categoryList: type: array items: type: object properties: categoryName: type: string id: type: integer pid: type: integer nullable: true region: type: string level: type: integer tkCategoryId: type: string x-apifox-orders: - categoryName - id - pid - region - level - tkCategoryId description: Product Categories priceList: type: array items: type: object properties: local: type: number title: Local currency amount region: type: number title: USD amount x-apifox-orders: - local - region tkVideoUrl: type: string description: TikTok video link x-apifox-orders: - videoId - videoCoverUrl - videoUrl - tkVideoUrl - videoDesc - videoDuration - discoverTime - createTime - updateTime - creatorUid - region - playCountInfo - likeCountInfo - shareCountInfo - commentCountInfo - soldCountInfo - currencySymbolInfo - gmvInfo - engageRate - adAwemeSource - itemId - itemName - itemPicUrl - categoryList - priceList required: - tkVideoUrl required: - total - pageNo - pageSize - data x-apifox-orders: - total - pageNo - pageSize - data serverTime: type: string required: - code - message - result - serverTime x-apifox-orders: - code - message - result - serverTime headers: {} x-apifox-name: Success x-200:Parameter Error: description: '' content: application/json: schema: type: object properties: code: type: string title: Response Code message: type: string title: Response Message result: type: 'null' title: Result serverTime: type: string title: Server Time required: - code - message - result - serverTime x-apifox-orders: - code - message - result - serverTime example: code: '4400' message: Invalid request parameters result: null serverTime: '2026-09-22 15:30:00' headers: {} x-apifox-name: Parameter Error x-200:Signature Error: description: '' content: application/json: schema: type: object properties: code: type: string title: Response Code message: type: string title: Response Message result: type: 'null' title: Result serverTime: type: string title: Server Time required: - code - message - result - serverTime x-apifox-orders: - code - message - result - serverTime examples: '3': summary: Signature does not match value: code: '4205' message: Signature does not match result: null serverTime: '2026-09-22 15:30:00' '4': summary: Missing signature headers value: code: '4202' message: Missing signature headers result: null serverTime: '2026-09-22 15:30:00' headers: {} x-apifox-name: Signature Error x-200:Server Error: description: '' content: application/json: schema: type: object properties: code: type: string title: Response Code message: type: string title: Response Message result: type: 'null' title: Result serverTime: type: string title: Server Time required: - code - message - result - serverTime x-apifox-orders: - code - message - result - serverTime examples: '5': summary: Server is busy value: code: '5003' message: Server is busy, please try again later result: null serverTime: '2026-09-22 15:30:00' '6': summary: Internal server error value: code: '5000' message: Internal server error result: null serverTime: '2026-09-22 15:30:00' headers: {} x-apifox-name: Server Error security: [] x-apifox-folder: Data APIs/Item Creator x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/6636689/apis/api-398465328-run components: schemas: {} securitySchemes: {} servers: - url: http://open.tabcut.com:8090 description: 正式环境 security: [] ```