获取商单任务列表/Get mission task list

[中文]

用途:

• 获取抖音创作者平台的商单任务列表
• 支持多种筛选条件，包括行业分类、付费类型、平台渠道等

重要参数使用说明:

行业分类组合规则:

• industry_lv1=-1 (全部): 当选择全部一级行业时，industry_lv2参数将被忽略，无需设置
• industry_lv1=具体值: 当选择具体一级行业时，可配合industry_lv2进行二级筛选
  • industry_lv2=-1: 该一级行业下的所有二级分类
  • industry_lv2=具体值: 该一级行业下的具体二级分类

可选参数 (选择"全部"时无需传入):

• platform_channel: 不传入表示全部平台渠道
• pay_type: 不传入表示全部付费类型
• greater_than_cost_progress: 不传入表示不限制成本进度
• publish_time_start: 不传入表示不限制发布时间
• quick_selector_scene: 不传入表示不使用快速筛选
• keyword: 不传入表示不进行关键词搜索

参数详解:

• cursor: 游标，用于分页，0表示第一页
• limit: 每页返回的任务数量，建议24
• mission_type: 任务类型，通常为1
• tab_scene: 场景类型
  • 1: 可投稿 (可以直接投稿的任务)
  • 2: 可报名 (需要报名审核的任务)
  • 3: 好物测评 (商品测评类任务)
• industry_lv1/lv2: 行业分类 (建议先调用fetch_industry_category_config获取完整分类)
  • -1: 全部行业
  • 具体数值: 对应具体行业类别 (如1913=游戏, 1903=食品饮料)
• platform_channel: 平台渠道 (可选)
  • 1: 抖音视频
  • 2: 抖音直播
  • 3: 抖音图文
• pay_type: 付费类型 (可选)
  • 1: 视频等级 (按粉丝量等级定价)
  • 2: 自定义 (商家自定义价格)
  • 3: 按转化付费 (按转化效果付费)
  • 4: 按有效播放量 (按播放量付费)
  • 5: 按销售量 (按商品销售量付费)
  • 9: 按核销量 (按核销数量付费)
  • 14: 按付费分佣 (按分佣比例付费)
• greater_than_cost_progress: 成本进度筛选 (可选)
  • 20: 高于20%成本进度的任务
  • 50: 高于50%成本进度的任务
  • 80: 高于80%成本进度的任务
• publish_time_start: 发布开始时间过滤 (可选，时间戳格式)
• quick_selector_scene: 快速筛选场景 (可选)
  • 1: 高收益任务
  • 4: 保底收入任务
  • 5: 曾经合作过的商家
• keyword: 关键词搜索 (可选，支持任务名称或任务ID)

使用示例:

# 获取全部行业的可投稿任务
GET /fetch_mission_task_list?industry_lv1=-1&tab_scene=1

# 获取游戏行业休闲游戏分类的按播放量付费任务
GET /fetch_mission_task_list?industry_lv1=1913&industry_lv2=191301&pay_type=4

# 获取高收益的抖音视频任务
GET /fetch_mission_task_list?platform_channel=1&quick_selector_scene=1

返回:

• 返回符合条件的商单任务列表
• 包含任务详情、报酬信息、要求等

[English]

Purpose:

• Get mission task list from Douyin Creator platform
• Supports multiple filtering conditions including industry classification, payment type, platform channel, etc.

Important Parameter Usage Guidelines:

Industry Classification Combination Rules:

• industry_lv1=-1 (All): When selecting all primary industries, industry_lv2 parameter will be ignored, no need to set
• industry_lv1=specific value: When selecting specific primary industry, can be combined with industry_lv2 for secondary filtering
  • industry_lv2=-1: All secondary categories under the primary industry
  • industry_lv2=specific value: Specific secondary category under the primary industry

Optional Parameters (No need to pass when selecting "All"):

• platform_channel: Not passing means all platform channels
• pay_type: Not passing means all payment types
• greater_than_cost_progress: Not passing means no cost progress restriction
• publish_time_start: Not passing means no publish time restriction
• quick_selector_scene: Not passing means no quick filtering
• keyword: Not passing means no keyword search

Parameter Details:

• cursor: Cursor for pagination, 0 for first page
• limit: Number of tasks per page, recommended 24
• mission_type: Mission type, usually 1
• tab_scene: Scene type
  • 1: Submittable (tasks that can be submitted directly)
  • 2: Registrable (tasks that require registration and approval)
  • 3: Product Review (product evaluation tasks)
• industry_lv1/lv2: Industry classification (recommend calling fetch_industry_category_config first)
  • -1: All industries
  • Specific values: Corresponding to specific industry categories (e.g., 1913=Gaming, 1903=Food&Beverage)
• platform_channel: Platform channel (optional)
  • 1: Douyin Video
  • 2: Douyin Live
  • 3: Douyin Image&Text
• pay_type: Payment type (optional)
  • 1: Video Level (pricing by follower level)
  • 2: Custom (merchant custom pricing)
  • 3: Conversion-based (pay by conversion effect)
  • 4: Valid Views (pay by view count)
  • 5: Sales Volume (pay by product sales)
  • 9: Verification Volume (pay by verification count)
  • 14: Commission-based (pay by commission ratio)
• greater_than_cost_progress: Cost progress filter (optional)
  • 20: Tasks with more than 20% cost progress
  • 50: Tasks with more than 50% cost progress
  • 80: Tasks with more than 80% cost progress
• publish_time_start: Publish start time filter (optional, timestamp format)
• quick_selector_scene: Quick filter scene (optional)
  • 1: High revenue tasks
  • 4: Guaranteed income tasks
  • 5: Previously collaborated merchants
• keyword: Keyword search (optional, supports task name or task ID)

Usage Examples:

# Get submittable tasks from all industries
GET /fetch_mission_task_list?industry_lv1=-1&tab_scene=1

# Get tasks from gaming industry casual games category with view-based payment
GET /fetch_mission_task_list?industry_lv1=1913&industry_lv2=191301&pay_type=4

# Get high-revenue Douyin video tasks
GET /fetch_mission_task_list?platform_channel=1&quick_selector_scene=1

Return:

• Returns mission task list matching the conditions
• Contains task details, compensation info, requirements, etc.

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.