LinkDigest Radar API

The Radar API from LinkDigest — 3 operation(s) for radar.

GitHub OpenAPI

Operations 6

GET /api/v1/radar The Pain-Point Radar runs on this key's account #
POST /api/v1/radar Pain-Point Radar: what people search for, complain about and ask on a topic… #
GET /api/v1/radar/{id} One radar run: 202 while it runs, 200 when done or failed #
PATCH /api/v1/radar/{id} Turn the weekly re-run on or off #
DELETE /api/v1/radar/{id} Delete a radar run #
POST /api/v1/radar/preview What people search for after a topic, grouped by need — no posts read #

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/linkdigest-dev:linkdigest-dev-radar-api"
All apis
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.

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.

OpenAPI Specification

linkdigest-dev-radar-api-openapi.yml Raw ↑
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.