{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/linkdigest-dev/json-schema/linkdigest-dev-radar-schema.json",
  "title": "Radar",
  "description": "A Pain-Point Radar run (痛点雷达).",
  "x-generated": "2026-11-17",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/linkdigest-dev-openapi.json#/components/schemas/Radar",
  "type": "object",
  "properties": {
    "radar_id": {
      "type": "string",
      "description": "The run's id."
    },
    "topic": {
      "type": "string",
      "description": "The topic."
    },
    "market": {
      "type": "string",
      "description": "cn or global."
    },
    "size": {
      "type": "string",
      "description": "quick, standard or deep."
    },
    "language": {
      "type": "string",
      "description": "The report's language."
    },
    "status": {
      "type": "string",
      "description": "searching, reading, aggregating, done or failed."
    },
    "created_at": {
      "type": "string",
      "description": "When it started (ISO 8601)."
    },
    "credits_total": {
      "type": "integer",
      "description": "Credits charged: the searches, the reads with insight and the aggregation."
    },
    "estimate": {
      "type": "integer",
      "description": "The estimate given before the run."
    },
    "posts_read": {
      "type": "integer",
      "description": "Posts read and aggregated."
    },
    "batch_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "The batch that read the posts (GET /api/v1/digest/batch/{id})."
    },
    "weekly": {
      "type": "boolean",
      "description": "Re-runs every week."
    },
    "radar": {
      "type": [
        "object",
        "null"
      ],
      "description": "The radar, when done.",
      "properties": {
        "summary": {
          "type": "string",
          "description": "One paragraph."
        },
        "posts": {
          "type": "integer",
          "description": "Posts aggregated."
        },
        "sections": {
          "type": "object",
          "description": "The clusters, most-mentioned first.",
          "properties": {
            "pain": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One cluster of findings.",
                "properties": {
                  "label": {
                    "type": "string",
                    "description": "The cluster, in the report's language."
                  },
                  "count_posts": {
                    "type": "integer",
                    "description": "How many of the posts read it came from — counted by code, not by the model."
                  },
                  "count_comments": {
                    "type": "integer",
                    "description": "How many of the top comments read fall in it."
                  },
                  "share": {
                    "type": "number",
                    "description": "count_posts / posts read, 0–1."
                  },
                  "heat": {
                    "type": "integer",
                    "description": "Summed engagement of those posts (likes + 2 × saves + comments)."
                  },
                  "quotes": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "description": "A quote.",
                      "properties": {
                        "text": {
                          "type": "string",
                          "description": "Verbatim from the post or one of its comments."
                        },
                        "gloss": {
                          "type": "string",
                          "description": "A translation into the report's language when the quote is in another one; else empty."
                        },
                        "note": {
                          "type": "integer",
                          "description": "Which post (1-based, in notes[])."
                        },
                        "kind": {
                          "type": "string",
                          "description": "caption, transcript, on_screen, image or comment."
                        },
                        "verified": {
                          "type": "boolean",
                          "description": "The engine found it word for word."
                        }
                      }
                    },
                    "description": "The quotes behind it."
                  },
                  "terms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "description": "A search suggestion or question."
                    },
                    "description": "For demand points the suggestions behind it; for gaps what is left unanswered."
                  }
                }
              },
              "description": "痛点: complaints, failures, regrets."
            },
            "needs": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One cluster of findings.",
                "properties": {
                  "label": {
                    "type": "string",
                    "description": "The cluster, in the report's language."
                  },
                  "count_posts": {
                    "type": "integer",
                    "description": "How many of the posts read it came from — counted by code, not by the model."
                  },
                  "count_comments": {
                    "type": "integer",
                    "description": "How many of the top comments read fall in it."
                  },
                  "share": {
                    "type": "number",
                    "description": "count_posts / posts read, 0–1."
                  },
                  "heat": {
                    "type": "integer",
                    "description": "Summed engagement of those posts (likes + 2 × saves + comments)."
                  },
                  "quotes": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "description": "A quote.",
                      "properties": {
                        "text": {
                          "type": "string",
                          "description": "Verbatim from the post or one of its comments."
                        },
                        "gloss": {
                          "type": "string",
                          "description": "A translation into the report's language when the quote is in another one; else empty."
                        },
                        "note": {
                          "type": "integer",
                          "description": "Which post (1-based, in notes[])."
                        },
                        "kind": {
                          "type": "string",
                          "description": "caption, transcript, on_screen, image or comment."
                        },
                        "verified": {
                          "type": "boolean",
                          "description": "The engine found it word for word."
                        }
                      }
                    },
                    "description": "The quotes behind it."
                  },
                  "terms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "description": "A search suggestion or question."
                    },
                    "description": "For demand points the suggestions behind it; for gaps what is left unanswered."
                  }
                }
              },
              "description": "需求与卖点: what buyers look for, and what the posts praise."
            },
            "blockers": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One cluster of findings.",
                "properties": {
                  "label": {
                    "type": "string",
                    "description": "The cluster, in the report's language."
                  },
                  "count_posts": {
                    "type": "integer",
                    "description": "How many of the posts read it came from — counted by code, not by the model."
                  },
                  "count_comments": {
                    "type": "integer",
                    "description": "How many of the top comments read fall in it."
                  },
                  "share": {
                    "type": "number",
                    "description": "count_posts / posts read, 0–1."
                  },
                  "heat": {
                    "type": "integer",
                    "description": "Summed engagement of those posts (likes + 2 × saves + comments)."
                  },
                  "quotes": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "description": "A quote.",
                      "properties": {
                        "text": {
                          "type": "string",
                          "description": "Verbatim from the post or one of its comments."
                        },
                        "gloss": {
                          "type": "string",
                          "description": "A translation into the report's language when the quote is in another one; else empty."
                        },
                        "note": {
                          "type": "integer",
                          "description": "Which post (1-based, in notes[])."
                        },
                        "kind": {
                          "type": "string",
                          "description": "caption, transcript, on_screen, image or comment."
                        },
                        "verified": {
                          "type": "boolean",
                          "description": "The engine found it word for word."
                        }
                      }
                    },
                    "description": "The quotes behind it."
                  },
                  "terms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "description": "A search suggestion or question."
                    },
                    "description": "For demand points the suggestions behind it; for gaps what is left unanswered."
                  }
                }
              },
              "description": "购买顾虑: what stops a purchase."
            },
            "products": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One cluster of findings.",
                "properties": {
                  "label": {
                    "type": "string",
                    "description": "The cluster, in the report's language."
                  },
                  "count_posts": {
                    "type": "integer",
                    "description": "How many of the posts read it came from — counted by code, not by the model."
                  },
                  "count_comments": {
                    "type": "integer",
                    "description": "How many of the top comments read fall in it."
                  },
                  "share": {
                    "type": "number",
                    "description": "count_posts / posts read, 0–1."
                  },
                  "heat": {
                    "type": "integer",
                    "description": "Summed engagement of those posts (likes + 2 × saves + comments)."
                  },
                  "quotes": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "description": "A quote.",
                      "properties": {
                        "text": {
                          "type": "string",
                          "description": "Verbatim from the post or one of its comments."
                        },
                        "gloss": {
                          "type": "string",
                          "description": "A translation into the report's language when the quote is in another one; else empty."
                        },
                        "note": {
                          "type": "integer",
                          "description": "Which post (1-based, in notes[])."
                        },
                        "kind": {
                          "type": "string",
                          "description": "caption, transcript, on_screen, image or comment."
                        },
                        "verified": {
                          "type": "boolean",
                          "description": "The engine found it word for word."
                        }
                      }
                    },
                    "description": "The quotes behind it."
                  },
                  "terms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "description": "A search suggestion or question."
                    },
                    "description": "For demand points the suggestions behind it; for gaps what is left unanswered."
                  }
                }
              },
              "description": "被点名的产品与价格带."
            },
            "open_questions": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One cluster of findings.",
                "properties": {
                  "label": {
                    "type": "string",
                    "description": "The cluster, in the report's language."
                  },
                  "count_posts": {
                    "type": "integer",
                    "description": "How many of the posts read it came from — counted by code, not by the model."
                  },
                  "count_comments": {
                    "type": "integer",
                    "description": "How many of the top comments read fall in it."
                  },
                  "share": {
                    "type": "number",
                    "description": "count_posts / posts read, 0–1."
                  },
                  "heat": {
                    "type": "integer",
                    "description": "Summed engagement of those posts (likes + 2 × saves + comments)."
                  },
                  "quotes": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "description": "A quote.",
                      "properties": {
                        "text": {
                          "type": "string",
                          "description": "Verbatim from the post or one of its comments."
                        },
                        "gloss": {
                          "type": "string",
                          "description": "A translation into the report's language when the quote is in another one; else empty."
                        },
                        "note": {
                          "type": "integer",
                          "description": "Which post (1-based, in notes[])."
                        },
                        "kind": {
                          "type": "string",
                          "description": "caption, transcript, on_screen, image or comment."
                        },
                        "verified": {
                          "type": "boolean",
                          "description": "The engine found it word for word."
                        }
                      }
                    },
                    "description": "The quotes behind it."
                  },
                  "terms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "description": "A search suggestion or question."
                    },
                    "description": "For demand points the suggestions behind it; for gaps what is left unanswered."
                  }
                }
              },
              "description": "Reader questions no post answers."
            },
            "demand": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One cluster of findings.",
                "properties": {
                  "label": {
                    "type": "string",
                    "description": "The cluster, in the report's language."
                  },
                  "count_posts": {
                    "type": "integer",
                    "description": "How many of the posts read it came from — counted by code, not by the model."
                  },
                  "count_comments": {
                    "type": "integer",
                    "description": "How many of the top comments read fall in it."
                  },
                  "share": {
                    "type": "number",
                    "description": "count_posts / posts read, 0–1."
                  },
                  "heat": {
                    "type": "integer",
                    "description": "Summed engagement of those posts (likes + 2 × saves + comments)."
                  },
                  "quotes": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "description": "A quote.",
                      "properties": {
                        "text": {
                          "type": "string",
                          "description": "Verbatim from the post or one of its comments."
                        },
                        "gloss": {
                          "type": "string",
                          "description": "A translation into the report's language when the quote is in another one; else empty."
                        },
                        "note": {
                          "type": "integer",
                          "description": "Which post (1-based, in notes[])."
                        },
                        "kind": {
                          "type": "string",
                          "description": "caption, transcript, on_screen, image or comment."
                        },
                        "verified": {
                          "type": "boolean",
                          "description": "The engine found it word for word."
                        }
                      }
                    },
                    "description": "The quotes behind it."
                  },
                  "terms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "description": "A search suggestion or question."
                    },
                    "description": "For demand points the suggestions behind it; for gaps what is left unanswered."
                  }
                }
              },
              "description": "搜索需求: the search suggestions, grouped by need."
            },
            "gaps": {
              "type": "array",
              "items": {
                "type": "object",
                "description": "One cluster of findings.",
                "properties": {
                  "label": {
                    "type": "string",
                    "description": "The cluster, in the report's language."
                  },
                  "count_posts": {
                    "type": "integer",
                    "description": "How many of the posts read it came from — counted by code, not by the model."
                  },
                  "count_comments": {
                    "type": "integer",
                    "description": "How many of the top comments read fall in it."
                  },
                  "share": {
                    "type": "number",
                    "description": "count_posts / posts read, 0–1."
                  },
                  "heat": {
                    "type": "integer",
                    "description": "Summed engagement of those posts (likes + 2 × saves + comments)."
                  },
                  "quotes": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "description": "A quote.",
                      "properties": {
                        "text": {
                          "type": "string",
                          "description": "Verbatim from the post or one of its comments."
                        },
                        "gloss": {
                          "type": "string",
                          "description": "A translation into the report's language when the quote is in another one; else empty."
                        },
                        "note": {
                          "type": "integer",
                          "description": "Which post (1-based, in notes[])."
                        },
                        "kind": {
                          "type": "string",
                          "description": "caption, transcript, on_screen, image or comment."
                        },
                        "verified": {
                          "type": "boolean",
                          "description": "The engine found it word for word."
                        }
                      }
                    },
                    "description": "The quotes behind it."
                  },
                  "terms": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "description": "A search suggestion or question."
                    },
                    "description": "For demand points the suggestions behind it; for gaps what is left unanswered."
                  }
                }
              },
              "description": "机会: demand or questions no post cluster covers."
            }
          }
        },
        "missing": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A limit."
          },
          "description": "What could not be read or supported."
        },
        "raw_markdown": {
          "type": "string",
          "description": "The report as Markdown."
        }
      }
    },
    "diff": {
      "type": [
        "object",
        "null"
      ],
      "description": "What changed since the previous run of the same topic.",
      "properties": {
        "since": {
          "type": [
            "string",
            "null"
          ],
          "description": "The previous run's date, or null for a first run."
        },
        "new_points": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A label."
          },
          "description": "Pain points and needs new this run."
        },
        "rising": {
          "type": "array",
          "items": {
            "type": "object",
            "description": "A rise of 0.15 or more.",
            "properties": {
              "label": {
                "type": "string",
                "description": "A label."
              },
              "from": {
                "type": "number",
                "description": "Share before."
              },
              "to": {
                "type": "number",
                "description": "Share now."
              }
            }
          },
          "description": "Rising."
        },
        "faded": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A label."
          },
          "description": "Gone since the last run."
        },
        "new_terms": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "A suggestion."
          },
          "description": "Search suggestions new since the last run."
        },
        "recent_share": {
          "type": "number",
          "description": "Share of the posts read that went up in the last 30 days."
        }
      }
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "A post read.",
        "properties": {
          "n": {
            "type": "integer",
            "description": "1-based."
          },
          "title": {
            "type": "string",
            "description": "The post's title."
          },
          "url": {
            "type": "string",
            "description": "The post."
          },
          "platform": {
            "type": "string",
            "description": "Its platform."
          },
          "heat": {
            "type": "integer",
            "description": "Its engagement."
          }
        }
      },
      "description": "The posts read, hottest first."
    },
    "share_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "A public link to the report, valid 30 days, once done."
    },
    "error": {
      "type": [
        "string",
        "null"
      ],
      "description": "Why it failed."
    },
    "poll": {
      "type": "string",
      "description": "This run's URL."
    }
  }
}