LinkDigest Radar API
The Radar API from LinkDigest — 3 operation(s) for radar.
The Radar API from LinkDigest — 3 operation(s) for radar.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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.curl "https://apis.io/api/v1/apis/linkdigest-dev:linkdigest-dev-radar-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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.
openapi: 3.2.0
info:
title: LinkDigest Radar API
version: 1.0.0
description: '把抖音、小红书、红果短剧、TikTok、YouTube、X、Instagram 的链接变成 AI 能读的文本:逐字稿、画面文字、逐图描述、要点,可选爆款拆解和翻译。Turns social links into LLM-ready text — transcript, on-screen text, images, key points, and an optional viral breakdown. 10 free credits when you sign up; a post is 1 credit, video 1 per started minute, or 1 per started 2 minutes read transcript-first (depth=transcript); cached links are free. Key: https://linkdigest.dev/signin?ref=openapi&next=/app/keys'
servers:
- url: https://linkdigest.dev
security:
- bearer: []
tags:
- name: Radar
paths:
/api/v1/radar:
get:
operationId: list_radars
summary: The Pain-Point Radar runs on this key's account
responses:
'200':
description: 'radars[]: radar_id, topic, market, size, status, created_at, credits_total, estimate, posts_read, weekly, share_url, pain_top (the three most-mentioned pain points)'
tags:
- Radar
post:
operationId: create_radar
summary: 'Pain-Point Radar: what people search for, complain about and ask on a topic…'
description: '痛点雷达 (2026-11-07). One topic → the search suggestions people type after it (Baidu, Taobao and Bing for market cn; Bing and YouTube for global), grouped by need; the posts two platforms hold about it (cn: Xiaohongshu + Douyin; global: YouTube + TikTok) read with the consumer insight; and every checked finding and top comment clustered into pain points, needs, purchase blockers, products, unanswered questions and gaps — each with how many of the posts it came from, counted by code, and quotes checked word for word. A re-run of the same topic says what changed since the last one. Answers 202; poll GET /api/v1/radar/{id}. Billed as its parts: the two searches, each post at its own price with insight (+1), and the aggregation (3 for 12 posts, 6 for 48); about 47 credits in all for a quick run. Fewer than 3 posts read: the aggregation is not charged. Without credits for a minimal radar: 402 insufficient_credits with the pay links.'
requestBody:
required: true
content:
application/json:
schema:
type: object
description: A topic to research.
properties:
topic:
type: string
description: A product, category or brand, as a person would search it (扫地机器人, robot vacuum). Not a link.
maxLength: 40
market:
type: string
description: 'cn: 小红书 + 抖音 and Chinese search suggestions (default). global: YouTube + TikTok and English suggestions, for 出海 sellers.'
enum:
- cn
- global
size:
type: string
description: quick 12 posts (default), standard 24, deep 48; fewer when the account's credits cover fewer (the estimate says how many).
enum:
- quick
- standard
- deep
language:
type: string
description: 'The report''s language: zh-CN (default), en or ja. Quotes stay in the post''s own words, with a gloss when foreign.'
enum:
- zh-CN
- en
- ja
weekly:
type: boolean
description: Run it again every week and mail what changed.
required:
- topic
responses:
'202':
description: 'The run, status searching: radar_id, estimate, poll.'
'402':
description: 'insufficient_credits: credits_needed, credits_left and the pay links.'
tags:
- Radar
/api/v1/radar/{id}:
get:
operationId: get_radar
summary: 'One radar run: 202 while it runs, 200 when done or failed'
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: format
in: query
required: false
description: 'md: the report as Markdown instead of JSON.'
schema:
type: string
enum:
- md
responses:
'200':
description: The finished (or failed) run.
content:
application/json:
schema:
$ref: '#/components/schemas/Radar'
'202':
description: Still searching, reading or aggregating.
content:
application/json:
schema:
$ref: '#/components/schemas/Radar'
'404':
description: No such radar on this account.
tags:
- Radar
patch:
operationId: update_radar
summary: Turn the weekly re-run on or off
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
description: What to change.
properties:
weekly:
type: boolean
description: Re-run every week and mail what changed.
responses:
'200':
description: The run.
'404':
description: No such radar.
tags:
- Radar
delete:
operationId: delete_radar
summary: Delete a radar run
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Deleted.
'404':
description: No such radar.
tags:
- Radar
/api/v1/radar/preview:
post:
operationId: radar_preview
summary: What people search for after a topic, grouped by need — no posts read
description: '需求词预览 (2026-11-07): the radar''s demand step alone. 1 credit, only when suggestions came back.'
requestBody:
required: true
content:
application/json:
schema:
type: object
description: A topic.
properties:
topic:
type: string
description: A product, category or brand. Not a link.
maxLength: 40
market:
type: string
description: cn (default) or global.
enum:
- cn
- global
required:
- topic
responses:
'200':
description: terms[] {term, source, seed}, clusters[] {label, key, terms[]}, hot[] {board, word, rank}, refused[], credits.
'402':
description: insufficient_credits.
tags:
- Radar
components:
schemas:
Radar:
type: object
description: A Pain-Point Radar run (痛点雷达).
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.
securitySchemes:
bearer:
type: http
scheme: bearer
description: Your API key (ld_live_…) from https://linkdigest.dev/signin?ref=openapi&next=/app/keys.