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. |
JSON Schema
{
"$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.
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.