`perception_part`

ReadRequires PerceptionCost 4

One part of the Brand Perception page, with processing status and public-safe evidence. On overview, include_threads=negative lists ordinary complaint discussions even when none qualifies as critical.

Input

Parameter	Type	Description
`channel`	`"all" \| "answer-engines" \| "social" \| "community" \| "web"`
`competitor`	`string`	max length 200
`days`	`7 \| 30 \| 90 \| 180 \| 365`	Perception snapshot window in days. min 1 · max 365 · default 30
`include_threads`	`"all" \| "negative"`	Overview only. Optional discussion evidence; negative means at least one counted negative opinion, without a critical-thread threshold.
`model`	`"CHATGPT" \| "GOOGLE_AIO"`
`part` required	`"meta" \| "overview" \| "knownFor" \| "competitors" \| "aiAnswers" \| "threeWay" \| "versus"`
`platform`	`string`	max length 100
`project_id` required	`string`	Authorized project ID.
`subject`	`string`	max length 200
`thread_limit`	`integer`	Maximum discussion rows when include_threads is set; defaults to 25. min 1 · max 100

Calling it

MCP

Tool call

read({ "name": "perception_part", "input": {} })

REST

curl

curl -X POST "https://app.sensorhub.ai/api/v1/read/perception_part" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{}
JSON

Input JSON Schema

json

{
  "additionalProperties": false,
  "properties": {
    "channel": {
      "enum": [
        "all",
        "answer-engines",
        "social",
        "community",
        "web"
      ],
      "type": "string"
    },
    "competitor": {
      "maxLength": 200,
      "type": "string"
    },
    "days": {
      "default": 30,
      "description": "Perception snapshot window in days.",
      "enum": [
        7,
        30,
        90,
        180,
        365
      ],
      "maximum": 365,
      "minimum": 1,
      "type": "integer"
    },
    "include_threads": {
      "description": "Overview only. Optional discussion evidence; negative means at least one counted negative opinion, without a critical-thread threshold.",
      "enum": [
        "all",
        "negative"
      ],
      "type": "string"
    },
    "model": {
      "enum": [
        "CHATGPT",
        "GOOGLE_AIO"
      ],
      "type": "string"
    },
    "part": {
      "enum": [
        "meta",
        "overview",
        "knownFor",
        "competitors",
        "aiAnswers",
        "threeWay",
        "versus"
      ],
      "type": "string"
    },
    "platform": {
      "maxLength": 100,
      "type": "string"
    },
    "project_id": {
      "description": "Authorized project ID.",
      "minLength": 1,
      "type": "string"
    },
    "subject": {
      "maxLength": 200,
      "type": "string"
    },
    "thread_limit": {
      "description": "Maximum discussion rows when include_threads is set; defaults to 25.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "project_id",
    "part"
  ],
  "type": "object"
}