# 内容搜索任务

按关键词搜索一个内容平台，可按需补充详情。

ID: native:search_social_content · Region: cn · Status: unknown

catalog_version: 5c920c774a55e44d7e8c709143b88a18b8b2afcef91a5d19a8c9ae5d565d9077
updated_at: 2026-10-21T12:06:16.523771+00:00

缓存资料；当前可用状态待核实。

按关键词搜索一个内容平台，可按需补充详情。

历史数据以数据集发布版本定义覆盖周期；实时读取反映请求时资料，不保证覆盖全部记录。

Docs: https://docs.asklear.cn/capabilities/native%3Asearch_social_content

## POST /v1/agent/run

native · unknown · api_key, oauth

REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。

按关键词搜索一个内容平台，可按需补充详情。

提交后按任务报价和授权执行；读取已保存结果免费。

请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。

等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。

### Input schema / 输入契约

```json
{
  "$defs": {
    "Schema1": {
      "additionalProperties": false,
      "properties": {
        "country": {
          "default": "US",
          "enum": [
            "US",
            "GB",
            "DE",
            "FR",
            "IN",
            "CA",
            "JP",
            "ES",
            "IT",
            "MX",
            "AE",
            "AU",
            "BR",
            "SA"
          ],
          "type": "string"
        },
        "include_trends": {
          "default": "true",
          "enum": [
            "true",
            "false"
          ],
          "type": "string"
        },
        "product": {
          "maxLength": 2048,
          "minLength": 10,
          "type": "string"
        }
      },
      "required": [
        "product"
      ],
      "type": "object"
    },
    "Schema2": {
      "additionalProperties": false,
      "properties": {
        "country": {
          "default": "US",
          "enum": [
            "US",
            "GB",
            "DE",
            "FR",
            "IN",
            "CA",
            "JP",
            "ES",
            "IT",
            "MX",
            "AE",
            "AU",
            "BR",
            "SA"
          ],
          "type": "string"
        },
        "page": {
          "default": 1,
          "maximum": 10000,
          "minimum": 1,
          "type": "integer"
        },
        "product": {
          "maxLength": 2048,
          "minLength": 10,
          "type": "string"
        },
        "since": {
          "default": "",
          "maxLength": 10,
          "type": "string"
        },
        "star": {
          "default": "all",
          "enum": [
            "all",
            "1",
            "2",
            "3",
            "4",
            "5"
          ],
          "type": "string"
        },
        "verified_purchase_only": {
          "default": "false",
          "enum": [
            "false",
            "true"
          ],
          "type": "string"
        }
      },
      "required": [
        "product"
      ],
      "type": "object"
    },
    "Schema3": {
      "additionalProperties": false,
      "properties": {
        "country": {
          "default": "US",
          "enum": [
            "US",
            "GB",
            "DE",
            "FR",
            "IN",
            "CA",
            "JP",
            "ES",
            "IT",
            "MX",
            "AE",
            "AU",
            "BR",
            "SA"
          ],
          "type": "string"
        },
        "page": {
          "default": 1,
          "maximum": 10000,
          "minimum": 1,
          "type": "integer"
        },
        "query": {
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "Schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "items": {
            "$ref": "#/$defs/Schema4"
          },
          "type": "array"
        },
        {
          "additionalProperties": {
            "$ref": "#/$defs/Schema4"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "Schema5": {
      "additionalProperties": false,
      "properties": {
        "platform": {
          "enum": [
            "xhs",
            "douyin",
            "bilibili",
            "weibo",
            "wechat",
            "wechat_channels",
            "web",
            "amazon",
            "facebook",
            "instagram",
            "jd",
            "kuaishou",
            "linkedin",
            "reddit",
            "search",
            "taobao",
            "tiktok",
            "twitter",
            "xianyu",
            "youtube",
            "zhihu"
          ],
          "type": "string"
        }
      },
      "required": [
        "platform"
      ],
      "type": "object"
    },
    "Schema6": {
      "additionalProperties": false,
      "properties": {
        "content_ref": {
          "anyOf": [
            {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "include_replies": {
          "default": false,
          "type": "boolean"
        },
        "max_comments": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "url": {
          "anyOf": [
            {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "type": "object"
    },
    "Schema7": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "items": {
            "$ref": "#/$defs/Schema7"
          },
          "type": "array"
        },
        {
          "additionalProperties": {
            "$ref": "#/$defs/Schema7"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "Schema8": {
      "additionalProperties": false,
      "properties": {
        "creator_ref": {
          "anyOf": [
            {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "include_details": {
          "default": false,
          "type": "boolean"
        },
        "recent_content_limit": {
          "anyOf": [
            {
              "exclusiveMinimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "url": {
          "anyOf": [
            {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "type": "object"
    },
    "Schema9": {
      "additionalProperties": false,
      "properties": {
        "filters": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/Schema7"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "include_details": {
          "default": false,
          "type": "boolean"
        },
        "max_items": {
          "anyOf": [
            {
              "exclusiveMinimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "pages": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "const": "max",
              "type": "string"
            }
          ],
          "default": 3
        },
        "platform": {
          "enum": [
            "xhs",
            "douyin",
            "bilibili",
            "weibo",
            "wechat",
            "wechat_channels",
            "web",
            "amazon",
            "facebook",
            "instagram",
            "jd",
            "kuaishou",
            "linkedin",
            "reddit",
            "search",
            "taobao",
            "tiktok",
            "twitter",
            "xianyu",
            "youtube",
            "zhihu"
          ],
          "type": "string"
        },
        "query": {
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "platform",
        "query"
      ],
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "approved_plan_digest": {
      "anyOf": [
        {
          "maxLength": 2048,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "idempotency_key": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "include_details": {
      "default": false,
      "type": "boolean"
    },
    "input": {
      "additionalProperties": false,
      "allOf": [
        {
          "if": {
            "properties": {
              "platform": {
                "const": "facebook"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "end_date": {
                    "default": null,
                    "maxLength": 10,
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "start_date": {
                    "default": null,
                    "maxLength": 10,
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 200,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "instagram"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {},
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "kuaishou"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "duration": {
                    "default": "all",
                    "description": "可选值: all(全部), under_1_min(1分钟以内), 1_to_5_min(1-5分钟), over_5_min(5分钟以上)",
                    "enum": [
                      "all",
                      "under_1_min",
                      "1_to_5_min",
                      "over_5_min"
                    ],
                    "type": "string"
                  },
                  "publish_time": {
                    "default": "all",
                    "enum": [
                      "all",
                      "one_day",
                      "one_week",
                      "one_month"
                    ],
                    "type": "string"
                  },
                  "sort_type": {
                    "default": "all",
                    "enum": [
                      "all",
                      "newest",
                      "most_likes"
                    ],
                    "type": "string"
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "reddit"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "allow_nsfw": {
                    "default": "0",
                    "description": "是否允许NSFW内容/Allow NSFW content: 0, 1",
                    "enum": [
                      "0",
                      "1"
                    ],
                    "type": "string"
                  },
                  "language": {
                    "default": "en-US",
                    "description": "返回内容使用的语言，采用 IETF 语言标签；默认 en-US / Preferred response language as an IETF language tag; default: en-US",
                    "maxLength": 16,
                    "minLength": 2,
                    "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
                    "type": "string"
                  },
                  "safe_search": {
                    "default": "unset",
                    "description": "安全搜索设置/Safe search setting: unset, strict",
                    "enum": [
                      "unset",
                      "strict"
                    ],
                    "type": "string"
                  },
                  "sort": {
                    "default": "RELEVANCE",
                    "enum": [
                      "RELEVANCE",
                      "HOT",
                      "TOP",
                      "NEW",
                      "COMMENTS"
                    ],
                    "type": "string"
                  },
                  "time_range": {
                    "default": "all",
                    "enum": [
                      "all",
                      "year",
                      "month",
                      "week",
                      "day",
                      "hour"
                    ],
                    "type": "string"
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "query": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "tiktok"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {},
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "youtube"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "duration": {
                    "anyOf": [
                      {
                        "enum": [
                          "short",
                          "medium",
                          "long"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "时长过滤/Duration filter: short (<4min), medium (4-20min), long (>20min)"
                  },
                  "features": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "特性过滤（逗号分隔）/Feature filter (comma separated): live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr"
                  },
                  "sort_by": {
                    "default": "",
                    "enum": [
                      "",
                      "relevance",
                      "upload_date",
                      "view_count",
                      "rating"
                    ],
                    "type": "string"
                  },
                  "type": {
                    "anyOf": [
                      {
                        "enum": [
                          "video",
                          "channel",
                          "playlist",
                          "movie"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "类型过滤/Type filter"
                  },
                  "upload_date": {
                    "default": "",
                    "enum": [
                      "",
                      "last_hour",
                      "today",
                      "this_week",
                      "this_month",
                      "this_year"
                    ],
                    "type": "string"
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 200,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "zhihu"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "limit": {
                    "anyOf": [
                      {
                        "pattern": "^[0-9]+$",
                        "type": "string"
                      },
                      {
                        "minimum": 1,
                        "type": "integer"
                      }
                    ],
                    "default": "20"
                  },
                  "search_hash_id": {
                    "default": "",
                    "description": "搜索哈希ID/Search Hash ID",
                    "type": "string"
                  },
                  "search_source": {
                    "default": "Normal",
                    "description": "搜索来源/Search Source",
                    "type": "string"
                  },
                  "show_all_topics": {
                    "default": 0,
                    "description": "显示所有主题/Show all topics",
                    "type": "integer"
                  },
                  "sort": {
                    "default": "",
                    "maxLength": 32,
                    "pattern": "^[\\x21-\\x7e]{0,32}$",
                    "type": "string"
                  },
                  "time_interval": {
                    "default": "",
                    "maxLength": 32,
                    "pattern": "^[\\x21-\\x7e]{0,32}$",
                    "type": "string"
                  },
                  "vertical": {
                    "default": "",
                    "description": "垂类/Vertical Type",
                    "type": "string"
                  },
                  "vertical_info": {
                    "default": "",
                    "description": "垂类信息/Vertical Info",
                    "type": "string"
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        }
      ],
      "properties": {
        "filters": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/Schema4"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "include_details": {
          "default": false,
          "type": "boolean"
        },
        "max_items": {
          "anyOf": [
            {
              "exclusiveMinimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "pages": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "const": "max",
              "type": "string"
            }
          ],
          "default": 3
        },
        "platform": {
          "enum": [
            "bilibili",
            "douyin",
            "facebook",
            "instagram",
            "kuaishou",
            "reddit",
            "tiktok",
            "twitter",
            "wechat",
            "weibo",
            "xhs",
            "youtube",
            "zhihu"
          ],
          "type": "string"
        },
        "query": {
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "platform",
        "query"
      ],
      "type": "object"
    },
    "max_credits": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "max_detail_items": {
      "anyOf": [
        {
          "maximum": 128,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "operation": {
      "const": "search_social_content"
    },
    "pages": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "const": "max",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "wait_seconds": {
      "default": 10,
      "maximum": 30,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "operation",
    "input",
    "idempotency_key"
  ],
  "type": "object"
}
```

### Synthetic request / 合成请求

```json
{
  "idempotency_key": "directory-example",
  "input": {
    "platform": "bilibili",
    "query": "example"
  },
  "operation": "search_social_content"
}
```

### Synthetic response / 合成响应

```json
{
  "billing": {
    "authorized_credits": 0,
    "reserved_credits": 0,
    "settled_credits": 0
  },
  "plan_version": 1,
  "progress": {
    "total_steps": 0
  },
  "state": "queued",
  "task_ref": "task-example"
}
```

- billing (object): 暂无字段说明
- billing.authorized_credits (integer): 暂无字段说明
- billing.reserved_credits (integer): 暂无字段说明
- billing.settled_credits (integer): 暂无字段说明
- completion (scalar): 暂无字段说明
- control (scalar): 暂无字段说明
- next_action (object): 暂无字段说明
- next_action.action (string): 暂无字段说明
- next_action.max_attempts (scalar): 暂无字段说明
- next_action.retry_mode (scalar): 暂无字段说明
- next_action.step_refs (scalar): 暂无字段说明
- next_result_ref (scalar): 暂无字段说明
- plan (scalar): 暂无字段说明
- plan_version (integer): 暂无字段说明
- poll_after_seconds (scalar): 暂无字段说明
- preview_only (boolean): 暂无字段说明
- progress (object): 暂无字段说明
- progress.failed (integer): 暂无字段说明
- progress.not_started (integer): 暂无字段说明
- progress.result_items (integer): 暂无字段说明
- progress.succeeded (integer): 暂无字段说明
- progress.total_steps (integer): 暂无字段说明
- progress.unknown (integer): 暂无字段说明
- result_expires_at (scalar): 暂无字段说明
- results (array): 暂无字段说明
- snapshot_ref (scalar): 暂无字段说明
- state (string): 暂无字段说明
- steps (array): 暂无字段说明
- task_ref (string): 暂无字段说明
- wait_seconds (scalar): 暂无字段说明

Follow up: GET /v1/data-tasks/{task_ref}
查看任务状态、授权操作和已保存结果。

## run

native · unknown · api_key, oauth

REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。

按关键词搜索一个内容平台，可按需补充详情。

提交后按任务报价和授权执行；读取已保存结果免费。

请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。

等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。

### Input schema / 输入契约

```json
{
  "$defs": {
    "Schema1": {
      "additionalProperties": false,
      "properties": {
        "country": {
          "default": "US",
          "enum": [
            "US",
            "GB",
            "DE",
            "FR",
            "IN",
            "CA",
            "JP",
            "ES",
            "IT",
            "MX",
            "AE",
            "AU",
            "BR",
            "SA"
          ],
          "type": "string"
        },
        "include_trends": {
          "default": "true",
          "enum": [
            "true",
            "false"
          ],
          "type": "string"
        },
        "product": {
          "maxLength": 2048,
          "minLength": 10,
          "type": "string"
        }
      },
      "required": [
        "product"
      ],
      "type": "object"
    },
    "Schema2": {
      "additionalProperties": false,
      "properties": {
        "country": {
          "default": "US",
          "enum": [
            "US",
            "GB",
            "DE",
            "FR",
            "IN",
            "CA",
            "JP",
            "ES",
            "IT",
            "MX",
            "AE",
            "AU",
            "BR",
            "SA"
          ],
          "type": "string"
        },
        "page": {
          "default": 1,
          "maximum": 10000,
          "minimum": 1,
          "type": "integer"
        },
        "product": {
          "maxLength": 2048,
          "minLength": 10,
          "type": "string"
        },
        "since": {
          "default": "",
          "maxLength": 10,
          "type": "string"
        },
        "star": {
          "default": "all",
          "enum": [
            "all",
            "1",
            "2",
            "3",
            "4",
            "5"
          ],
          "type": "string"
        },
        "verified_purchase_only": {
          "default": "false",
          "enum": [
            "false",
            "true"
          ],
          "type": "string"
        }
      },
      "required": [
        "product"
      ],
      "type": "object"
    },
    "Schema3": {
      "additionalProperties": false,
      "properties": {
        "country": {
          "default": "US",
          "enum": [
            "US",
            "GB",
            "DE",
            "FR",
            "IN",
            "CA",
            "JP",
            "ES",
            "IT",
            "MX",
            "AE",
            "AU",
            "BR",
            "SA"
          ],
          "type": "string"
        },
        "page": {
          "default": 1,
          "maximum": 10000,
          "minimum": 1,
          "type": "integer"
        },
        "query": {
          "maxLength": 200,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "Schema4": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "items": {
            "$ref": "#/$defs/Schema4"
          },
          "type": "array"
        },
        {
          "additionalProperties": {
            "$ref": "#/$defs/Schema4"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "Schema5": {
      "additionalProperties": false,
      "properties": {
        "platform": {
          "enum": [
            "xhs",
            "douyin",
            "bilibili",
            "weibo",
            "wechat",
            "wechat_channels",
            "web",
            "amazon",
            "facebook",
            "instagram",
            "jd",
            "kuaishou",
            "linkedin",
            "reddit",
            "search",
            "taobao",
            "tiktok",
            "twitter",
            "xianyu",
            "youtube",
            "zhihu"
          ],
          "type": "string"
        }
      },
      "required": [
        "platform"
      ],
      "type": "object"
    },
    "Schema6": {
      "additionalProperties": false,
      "properties": {
        "content_ref": {
          "anyOf": [
            {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "include_replies": {
          "default": false,
          "type": "boolean"
        },
        "max_comments": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "url": {
          "anyOf": [
            {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "type": "object"
    },
    "Schema7": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "items": {
            "$ref": "#/$defs/Schema7"
          },
          "type": "array"
        },
        {
          "additionalProperties": {
            "$ref": "#/$defs/Schema7"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "Schema8": {
      "additionalProperties": false,
      "properties": {
        "creator_ref": {
          "anyOf": [
            {
              "maxLength": 2048,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "include_details": {
          "default": false,
          "type": "boolean"
        },
        "recent_content_limit": {
          "anyOf": [
            {
              "exclusiveMinimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "url": {
          "anyOf": [
            {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "type": "object"
    },
    "Schema9": {
      "additionalProperties": false,
      "properties": {
        "filters": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/Schema7"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "include_details": {
          "default": false,
          "type": "boolean"
        },
        "max_items": {
          "anyOf": [
            {
              "exclusiveMinimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "pages": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "const": "max",
              "type": "string"
            }
          ],
          "default": 3
        },
        "platform": {
          "enum": [
            "xhs",
            "douyin",
            "bilibili",
            "weibo",
            "wechat",
            "wechat_channels",
            "web",
            "amazon",
            "facebook",
            "instagram",
            "jd",
            "kuaishou",
            "linkedin",
            "reddit",
            "search",
            "taobao",
            "tiktok",
            "twitter",
            "xianyu",
            "youtube",
            "zhihu"
          ],
          "type": "string"
        },
        "query": {
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "platform",
        "query"
      ],
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "approved_plan_digest": {
      "anyOf": [
        {
          "maxLength": 2048,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "idempotency_key": {
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    },
    "include_details": {
      "default": false,
      "type": "boolean"
    },
    "input": {
      "additionalProperties": false,
      "allOf": [
        {
          "if": {
            "properties": {
              "platform": {
                "const": "facebook"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "end_date": {
                    "default": null,
                    "maxLength": 10,
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "start_date": {
                    "default": null,
                    "maxLength": 10,
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 200,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "instagram"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {},
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "kuaishou"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "duration": {
                    "default": "all",
                    "description": "可选值: all(全部), under_1_min(1分钟以内), 1_to_5_min(1-5分钟), over_5_min(5分钟以上)",
                    "enum": [
                      "all",
                      "under_1_min",
                      "1_to_5_min",
                      "over_5_min"
                    ],
                    "type": "string"
                  },
                  "publish_time": {
                    "default": "all",
                    "enum": [
                      "all",
                      "one_day",
                      "one_week",
                      "one_month"
                    ],
                    "type": "string"
                  },
                  "sort_type": {
                    "default": "all",
                    "enum": [
                      "all",
                      "newest",
                      "most_likes"
                    ],
                    "type": "string"
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "reddit"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "allow_nsfw": {
                    "default": "0",
                    "description": "是否允许NSFW内容/Allow NSFW content: 0, 1",
                    "enum": [
                      "0",
                      "1"
                    ],
                    "type": "string"
                  },
                  "language": {
                    "default": "en-US",
                    "description": "返回内容使用的语言，采用 IETF 语言标签；默认 en-US / Preferred response language as an IETF language tag; default: en-US",
                    "maxLength": 16,
                    "minLength": 2,
                    "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
                    "type": "string"
                  },
                  "safe_search": {
                    "default": "unset",
                    "description": "安全搜索设置/Safe search setting: unset, strict",
                    "enum": [
                      "unset",
                      "strict"
                    ],
                    "type": "string"
                  },
                  "sort": {
                    "default": "RELEVANCE",
                    "enum": [
                      "RELEVANCE",
                      "HOT",
                      "TOP",
                      "NEW",
                      "COMMENTS"
                    ],
                    "type": "string"
                  },
                  "time_range": {
                    "default": "all",
                    "enum": [
                      "all",
                      "year",
                      "month",
                      "week",
                      "day",
                      "hour"
                    ],
                    "type": "string"
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "query": {
                "maxLength": 512,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "tiktok"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {},
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "youtube"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "duration": {
                    "anyOf": [
                      {
                        "enum": [
                          "short",
                          "medium",
                          "long"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "时长过滤/Duration filter: short (<4min), medium (4-20min), long (>20min)"
                  },
                  "features": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "特性过滤（逗号分隔）/Feature filter (comma separated): live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr"
                  },
                  "sort_by": {
                    "default": "",
                    "enum": [
                      "",
                      "relevance",
                      "upload_date",
                      "view_count",
                      "rating"
                    ],
                    "type": "string"
                  },
                  "type": {
                    "anyOf": [
                      {
                        "enum": [
                          "video",
                          "channel",
                          "playlist",
                          "movie"
                        ],
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "类型过滤/Type filter"
                  },
                  "upload_date": {
                    "default": "",
                    "enum": [
                      "",
                      "last_hour",
                      "today",
                      "this_week",
                      "this_month",
                      "this_year"
                    ],
                    "type": "string"
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 200,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "platform": {
                "const": "zhihu"
              }
            }
          },
          "then": {
            "properties": {
              "filters": {
                "additionalProperties": false,
                "properties": {
                  "limit": {
                    "anyOf": [
                      {
                        "pattern": "^[0-9]+$",
                        "type": "string"
                      },
                      {
                        "minimum": 1,
                        "type": "integer"
                      }
                    ],
                    "default": "20"
                  },
                  "search_hash_id": {
                    "default": "",
                    "description": "搜索哈希ID/Search Hash ID",
                    "type": "string"
                  },
                  "search_source": {
                    "default": "Normal",
                    "description": "搜索来源/Search Source",
                    "type": "string"
                  },
                  "show_all_topics": {
                    "default": 0,
                    "description": "显示所有主题/Show all topics",
                    "type": "integer"
                  },
                  "sort": {
                    "default": "",
                    "maxLength": 32,
                    "pattern": "^[\\x21-\\x7e]{0,32}$",
                    "type": "string"
                  },
                  "time_interval": {
                    "default": "",
                    "maxLength": 32,
                    "pattern": "^[\\x21-\\x7e]{0,32}$",
                    "type": "string"
                  },
                  "vertical": {
                    "default": "",
                    "description": "垂类/Vertical Type",
                    "type": "string"
                  },
                  "vertical_info": {
                    "default": "",
                    "description": "垂类信息/Vertical Info",
                    "type": "string"
                  }
                },
                "type": [
                  "object",
                  "null"
                ]
              },
              "include_details": {
                "const": false
              },
              "query": {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              }
            }
          }
        }
      ],
      "properties": {
        "filters": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/Schema4"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "include_details": {
          "default": false,
          "type": "boolean"
        },
        "max_items": {
          "anyOf": [
            {
              "exclusiveMinimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "pages": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "const": "max",
              "type": "string"
            }
          ],
          "default": 3
        },
        "platform": {
          "enum": [
            "bilibili",
            "douyin",
            "facebook",
            "instagram",
            "kuaishou",
            "reddit",
            "tiktok",
            "twitter",
            "wechat",
            "weibo",
            "xhs",
            "youtube",
            "zhihu"
          ],
          "type": "string"
        },
        "query": {
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "platform",
        "query"
      ],
      "type": "object"
    },
    "max_credits": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "max_detail_items": {
      "anyOf": [
        {
          "maximum": 128,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "operation": {
      "const": "search_social_content"
    },
    "pages": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "const": "max",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "task_query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.",
      "maxLength": 300
    },
    "wait_seconds": {
      "default": 10,
      "maximum": 30,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "operation",
    "input",
    "idempotency_key"
  ],
  "type": "object"
}
```

### Synthetic request / 合成请求

```json
{
  "idempotency_key": "directory-example",
  "input": {
    "platform": "bilibili",
    "query": "example"
  },
  "operation": "search_social_content"
}
```

### Synthetic response / 合成响应

```json
{
  "billing": {
    "authorized_credits": 0,
    "reserved_credits": 0,
    "settled_credits": 0
  },
  "plan_version": 1,
  "progress": {
    "total_steps": 0
  },
  "state": "queued",
  "task_ref": "task-example"
}
```

- billing (object): 暂无字段说明
- billing.authorized_credits (integer): 暂无字段说明
- billing.reserved_credits (integer): 暂无字段说明
- billing.settled_credits (integer): 暂无字段说明
- completion (scalar): 暂无字段说明
- control (scalar): 暂无字段说明
- next_action (object): 暂无字段说明
- next_action.action (string): 暂无字段说明
- next_action.max_attempts (scalar): 暂无字段说明
- next_action.retry_mode (scalar): 暂无字段说明
- next_action.step_refs (scalar): 暂无字段说明
- next_result_ref (scalar): 暂无字段说明
- plan (scalar): 暂无字段说明
- plan_version (integer): 暂无字段说明
- poll_after_seconds (scalar): 暂无字段说明
- preview_only (boolean): 暂无字段说明
- progress (object): 暂无字段说明
- progress.failed (integer): 暂无字段说明
- progress.not_started (integer): 暂无字段说明
- progress.result_items (integer): 暂无字段说明
- progress.succeeded (integer): 暂无字段说明
- progress.total_steps (integer): 暂无字段说明
- progress.unknown (integer): 暂无字段说明
- result_expires_at (scalar): 暂无字段说明
- results (array): 暂无字段说明
- snapshot_ref (scalar): 暂无字段说明
- state (string): 暂无字段说明
- steps (array): 暂无字段说明
- task_ref (string): 暂无字段说明
- wait_seconds (scalar): 暂无字段说明

Follow up: GET /v1/data-tasks/{task_ref}
查看任务状态、授权操作和已保存结果。

