Get a shared conversion

GET/s/{id}

Returns a cached conversion by its share id. If the copy is more than an hour old, PullMD fetches the source again first. If the source is gone, you get the last good copy, so share links keep working after the original page disappears.

Share links never need sign-in. They expire with their cache row (PULLMD_CACHE_RETENTION_DAYS, 90 days by default), and stop working at once when the conversion is deleted from the cache for everyone. See DELETE /api/cache/{id} for who can do that.

Path parameters

idstringrequired

The 32-character hex share id from the X-Share-Id header or shareId field.

Example: 2f2f4a7b37f071b7e3137d42eb9dbec3

Query parameters

formatstring

text strips the Markdown syntax. Any other value returns Markdown.

Default: "md"Available options: mdtext

Response

200 · text/markdown, text/plain

The cached Markdown.

Response headers

X-Suggested-Filenamestring

A download file name for the result, such as YT-some-talk-dQw4w9WgXcQ.md.

cURL

curl --request GET \
  --url 'http://localhost:3000/s/{id}'

# Example Domain

This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.

[Learn more](https://iana.org/help/example-domains)