Plaudownloader API (1.0.0)

Download OpenAPI specification:

Fetch transcriptions and AI summaries from Plaud public share links. Public and unauthenticated. Responses are cached by share id.

Results are always returned in chronological order by recording start time, after de-duplicating repeated share ids.

Fetch (and optionally download) transcriptions for one or more Plaud share links

query Parameters
format
string
Default: "json"
Enum: "json" "txt"

Payload type. json (default) returns normalized JSON, also used by the UI preview. txt returns plain-text transcript file(s).

zip
boolean
Default: false

When true, the response is a ZIP bundle with one file per link, named <Index>_<YYYY-MM-DD_HH-MM>_<Title>.<ext> (1-based index in chronological order). When false (default) a single file/document is returned: a JSON array for format=json, or one .txt for format=txt named <YYYY-MM-DD_HH-MM>_<Title>.<ext>. The caller decides when to request a ZIP (e.g. the UI sets it for multi-link downloads).

refresh
boolean
Default: false

Bypass the cache and refetch from Plaud.

Request Body schema: application/json
required
links
required
Array of strings non-empty

Plaud share URLs or bare pub_...::token slugs.

include_summary
boolean
Default: false

Include AI Summary, Highlights and Outline in the output.

Responses

Response Schema:
Array
id
required
string

Share id (pub_...).

url
required
string
status
required
string
Enum: "ok" "error"
object (Error)
required
object
title
string
start_time
string or null <date-time>
duration_ms
integer or null
language
string or null
filename
required
string

Suggested <YYYY-MM-DD_HH-MM>_<Title>.<ext>, e.g. 2026-07-06_11-28_Meeting.txt.

Array of objects (Segment)
Array
speaker
string
start_ms
integer
end_ms
integer
text
string
object (Summary)
markdown
string
Array of objects (Highlight)
Array
title
string
content
string
timestamp_ms
integer
Array of objects (OutlineItem)
Array
topic
string
start_ms
integer
end_ms
integer

Request samples

Content type
application/json
{
  • "links": [
    ],
  • "include_summary": false
}

Response samples

Content type
[
  • {
    }
]