LinkDigest Watch API

The Watch API from LinkDigest — 2 operation(s) for watch.

GitHub OpenAPI

Operations 5

GET /api/v1/watch The daily briefs on this key's account #
POST /api/v1/watch Watch a topic: every day, its hottest new posts read, compared, and one post… #
GET /api/v1/watch/{id} One watch #
PATCH /api/v1/watch/{id} Pause, resume, run now, change the voice or the hour #
DELETE /api/v1/watch/{id} Delete a watch #

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-watch-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-watch-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: LinkDigest Watch 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: Watch
paths:
  /api/v1/watch:
    get:
      operationId: list_watches
      summary: The daily briefs on this key's account
      responses:
        '200':
          description: 'watches[]: watch_id, query, platform, draft_platform, status, hour_utc, next_run_at, runs, last {outcome, new_posts, credits, batch_id, share_url}'
      tags:
      - Watch
    post:
      operationId: create_watch
      summary: 'Watch a topic: every day, its hottest new posts read, compared, and one post…'
      description: 'The daily brief (每日稿, 2026-10-31). Each day at hour_utc the topic is searched on the platform, the posts not read before are read (5, with the rest of the search in reserve for any that will not read), ranked, compared, and a post is written from them in draft_platform''s shape — in the account''s voice when voice carries a sample — and mailed to the account''s address with a share link. Charged as the batch it starts (search + reads + comparison + draft, about 8–12 credits); a day with nothing new costs nothing; an account that cannot pay is mailed instead and tried again the next day. The first run starts at once. Over the plan''s limit (free 1, Dev 5, Studio 20): 402 watch_limit.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: A topic to watch.
              properties:
                query:
                  type: string
                  description: The topic, as a person would search it (露营装备, 考研英语).
                  maxLength: 200
                platform:
                  type: string
                  description: xiaohongshu or douyin.
                  enum:
                  - xiaohongshu
                  - douyin
                draft_platform:
                  type: string
                  description: 'The post''s shape: xiaohongshu (default for a Xiaohongshu watch), douyin (口播稿), en.'
                  enum:
                  - xiaohongshu
                  - douyin
                  - en
                voice:
                  type: string
                  description: A sample of the creator's own writing; the post matches its tone.
                  maxLength: 1500
                hour_utc:
                  type: integer
                  minimum: 0
                  maximum: 23
                  description: The hour (UTC) it runs; default 1 (09:00 Beijing).
                reads:
                  type: integer
                  minimum: 1
                  maximum: 20
                  description: Posts one run reads (default 5, up to 20 within the plan's batch size; as many as the search finds).
              required:
              - query
              - platform
      responses:
        '201':
          description: The watch.
        '402':
          description: 'watch_limit: the plan''s watches are all in use.'
      tags:
      - Watch
  /api/v1/watch/{id}:
    get:
      operationId: get_watch
      summary: One watch
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The watch.
        '404':
          description: No such watch.
      tags:
      - Watch
    patch:
      operationId: update_watch
      summary: Pause, resume, run now, change the voice or the hour
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: What to change.
              properties:
                status:
                  type: string
                  description: active or paused.
                  enum:
                  - active
                  - paused
                run_now:
                  type: boolean
                  description: Run at the next tick instead of waiting for the hour.
                voice:
                  type: string
                  description: A new voice sample; null removes it.
                  maxLength: 1500
                hour_utc:
                  type: integer
                  minimum: 0
                  maximum: 23
                reads:
                  type: integer
                  minimum: 1
                  maximum: 20
      responses:
        '200':
          description: The watch.
        '404':
          description: No such watch.
      tags:
      - Watch
    delete:
      operationId: delete_watch
      summary: Delete a watch
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Deleted.
        '404':
          description: No such watch.
      tags:
      - Watch
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: Your API key (ld_live_…) from https://linkdigest.dev/signin?ref=openapi&next=/app/keys.