LinkDigest · Schema

Radar

A Pain-Point Radar run (痛点雷达).

Artificial IntelligenceSocial MediaData ExtractionSearchContent Aggregation

Properties

Name Type Description
radar_id string The run's id.
topic string The topic.
market string cn or global.
size string quick, standard or deep.
language string The report's language.
status string searching, reading, aggregating, done or failed.
created_at string When it started (ISO 8601).
credits_total integer Credits charged: the searches, the reads with insight and the aggregation.
estimate integer The estimate given before the run.
posts_read integer Posts read and aggregated.
batch_id stringnull The batch that read the posts (GET /api/v1/digest/batch/{id}).
weekly boolean Re-runs every week.
radar objectnull The radar, when done.
diff objectnull What changed since the previous run of the same topic.
notes array The posts read, hottest first.
share_url stringnull A public link to the report, valid 30 days, once done.
error stringnull Why it failed.
poll string This run's URL.
View JSON Schema on GitHub

JSON Schema

linkdigest-dev-radar-schema.json Raw ↑
{
  "$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."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/linkdigest-dev-radar"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.