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.
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.