# Research social creator

Research a creator profile and recent public content. Submit for a quote and approval before execution. Reading saved results is free.

ID: native:research_social_creator · Region: global · Status: available

catalog_version: 1d0d6a1c969fdf327cc670c6e09e30955e8d31a1effc0d3a58d90184ad911f57
updated_at: 2026-10-27T04:03:01.944414+00:00

Research a creator profile and recent public content. Submit for a quote and approval before execution. Reading saved results is free.

Dataset releases define historical periods; live reads describe request-time data and do not guarantee completeness.

Docs: https://docs.kleardata.ai/capabilities/native%3Aresearch_social_creator

## POST /v1/agent/run

native · available · api_key, oauth

REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command.

Research a creator profile and recent public content. Submit for a quote and approval before execution. Reading saved results is free.

Submit for the existing task quote and approval; reading saved results is free.

Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only.

A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying.

### 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": {
      "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"
    },
    "Schema5": {
      "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"
    },
    "Schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "items": {
            "$ref": "#/$defs/Schema6"
          },
          "type": "array"
        },
        {
          "additionalProperties": {
            "$ref": "#/$defs/Schema6"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "Schema7": {
      "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"
    },
    "Schema8": {
      "additionalProperties": false,
      "properties": {
        "filters": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/Schema6"
              },
              "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,
      "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"
    },
    "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": "research_social_creator"
    },
    "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": {
    "url": "https://www.xiaohongshu.com/user/profile/65f000000000000000000001"
  },
  "operation": "research_social_creator"
}
```

### 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): No field description available
- billing.authorized_credits (integer): No field description available
- billing.reserved_credits (integer): No field description available
- billing.settled_credits (integer): No field description available
- completion (scalar): No field description available
- control (scalar): No field description available
- next_action (object): No field description available
- next_action.action (string): No field description available
- next_action.max_attempts (scalar): No field description available
- next_action.retry_mode (scalar): No field description available
- next_action.step_refs (scalar): No field description available
- next_result_ref (scalar): No field description available
- plan (scalar): No field description available
- plan_version (integer): No field description available
- poll_after_seconds (scalar): No field description available
- preview_only (boolean): No field description available
- progress (object): No field description available
- progress.failed (integer): No field description available
- progress.not_started (integer): No field description available
- progress.result_items (integer): No field description available
- progress.succeeded (integer): No field description available
- progress.total_steps (integer): No field description available
- progress.unknown (integer): No field description available
- result_expires_at (scalar): No field description available
- results (array): No field description available
- snapshot_ref (scalar): No field description available
- state (string): No field description available
- steps (array): No field description available
- task_ref (string): No field description available
- wait_seconds (scalar): No field description available

Follow up: GET /v1/data-tasks/{task_ref}
Read task status, approval controls and saved results.

## run

native · available · api_key, oauth

REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command.

Research a creator profile and recent public content. Submit for a quote and approval before execution. Reading saved results is free.

Submit for the existing task quote and approval; reading saved results is free.

Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only.

A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying.

### 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": {
      "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"
    },
    "Schema5": {
      "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"
    },
    "Schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "items": {
            "$ref": "#/$defs/Schema6"
          },
          "type": "array"
        },
        {
          "additionalProperties": {
            "$ref": "#/$defs/Schema6"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "Schema7": {
      "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"
    },
    "Schema8": {
      "additionalProperties": false,
      "properties": {
        "filters": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/Schema6"
              },
              "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,
      "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"
    },
    "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": "research_social_creator"
    },
    "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": {
    "url": "https://www.xiaohongshu.com/user/profile/65f000000000000000000001"
  },
  "operation": "research_social_creator"
}
```

### 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): No field description available
- billing.authorized_credits (integer): No field description available
- billing.reserved_credits (integer): No field description available
- billing.settled_credits (integer): No field description available
- completion (scalar): No field description available
- control (scalar): No field description available
- next_action (object): No field description available
- next_action.action (string): No field description available
- next_action.max_attempts (scalar): No field description available
- next_action.retry_mode (scalar): No field description available
- next_action.step_refs (scalar): No field description available
- next_result_ref (scalar): No field description available
- plan (scalar): No field description available
- plan_version (integer): No field description available
- poll_after_seconds (scalar): No field description available
- preview_only (boolean): No field description available
- progress (object): No field description available
- progress.failed (integer): No field description available
- progress.not_started (integer): No field description available
- progress.result_items (integer): No field description available
- progress.succeeded (integer): No field description available
- progress.total_steps (integer): No field description available
- progress.unknown (integer): No field description available
- result_expires_at (scalar): No field description available
- results (array): No field description available
- snapshot_ref (scalar): No field description available
- state (string): No field description available
- steps (array): No field description available
- task_ref (string): No field description available
- wait_seconds (scalar): No field description available

Follow up: GET /v1/data-tasks/{task_ref}
Read task status, approval controls and saved results.

## asklear run

native · available · api_key, oauth

REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command.

Research a creator profile and recent public content. Submit for a quote and approval before execution. Reading saved results is free.

Submit for the existing task quote and approval; reading saved results is free.

Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only.

A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying.

### 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": {
      "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"
    },
    "Schema5": {
      "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"
    },
    "Schema6": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "items": {
            "$ref": "#/$defs/Schema6"
          },
          "type": "array"
        },
        {
          "additionalProperties": {
            "$ref": "#/$defs/Schema6"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "Schema7": {
      "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"
    },
    "Schema8": {
      "additionalProperties": false,
      "properties": {
        "filters": {
          "anyOf": [
            {
              "additionalProperties": {
                "$ref": "#/$defs/Schema6"
              },
              "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,
      "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"
    },
    "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": "research_social_creator"
    },
    "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": {
    "url": "https://www.xiaohongshu.com/user/profile/65f000000000000000000001"
  },
  "operation": "research_social_creator"
}
```

### 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): No field description available
- billing.authorized_credits (integer): No field description available
- billing.reserved_credits (integer): No field description available
- billing.settled_credits (integer): No field description available
- completion (scalar): No field description available
- control (scalar): No field description available
- next_action (object): No field description available
- next_action.action (string): No field description available
- next_action.max_attempts (scalar): No field description available
- next_action.retry_mode (scalar): No field description available
- next_action.step_refs (scalar): No field description available
- next_result_ref (scalar): No field description available
- plan (scalar): No field description available
- plan_version (integer): No field description available
- poll_after_seconds (scalar): No field description available
- preview_only (boolean): No field description available
- progress (object): No field description available
- progress.failed (integer): No field description available
- progress.not_started (integer): No field description available
- progress.result_items (integer): No field description available
- progress.succeeded (integer): No field description available
- progress.total_steps (integer): No field description available
- progress.unknown (integer): No field description available
- result_expires_at (scalar): No field description available
- results (array): No field description available
- snapshot_ref (scalar): No field description available
- state (string): No field description available
- steps (array): No field description available
- task_ref (string): No field description available
- wait_seconds (scalar): No field description available

Follow up: GET /v1/data-tasks/{task_ref}
Read task status, approval controls and saved results.

