YOLO PUSHYOLO PUSHBETA✦

URL to Markdown & Video

Convert public URLs to clean, LLM-ready markdown, capture screenshots, or render smooth scrolling MP4s at a controlled speed. Every destination and redirect is validated before fetching.

MarkdownScreenshotsScrolling MP4
https://md.yolopush.com/<url>

Try it

Scrolling video API

Turn a public page into a smooth scrolling video

Submit a URL and scroll speed, then receive a seekable MP4 suitable for demos, launch posts, product previews, and automated content pipelines.

OpenAPI 3.1

Smooth MP4 output

Live Chromium compositor frames normalized to 30 fps H.264 with fast-start playback.

Controlled scroll speed

Use slow (160 px/s), normal (240), fast (400), or a custom speed from 80–800 px/s.

Asynchronous rendering

Queue a 2–30 second render, poll its status, then stream the result with HTTP Range support.

How it works

  1. 1Queue. POST a public URL and receive 202 Accepted with a statusUrl.
  2. 2Poll. Check the status while the job is queued or processing.
  3. 3Play. When ready, stream or download videoUrl as an H.264 MP4.
API key required

Keep SCROLL_VIDEO_API_KEY in your backend or deployment secret manager. Never ship the shared key in browser code. The live Toolbox intentionally does not ask for or expose it.

Results and job records expire after seven days. Public HTTP/HTTPS pages on default ports are supported; authenticated-page cookies are not forwarded.

Server-side examples

Set the environment variable in the calling service, then run the sequence below.

1. Create a normal-speed video
curl --request POST 'https://md.yolopush.com/v1/scroll-videos' \
  --header "Authorization: Bearer ${SCROLL_VIDEO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "url": "https://example.com",
    "speed": "normal",
    "maxDurationSeconds": 20,
    "viewport": { "width": 1280, "height": 720 },
    "waitAfterLoadMs": 2000
  }'
2. Poll the render job
curl --header "Authorization: Bearer ${SCROLL_VIDEO_API_KEY}" \
  'https://md.yolopush.com/v1/scroll-videos/<job-id>'
3. Download the MP4
curl --header "Authorization: Bearer ${SCROLL_VIDEO_API_KEY}" \
  --output scroll.mp4 \
  'https://md.yolopush.com/v1/scroll-videos/<job-id>/video'

5-Layer Cascade Pipeline

1
Quick ExtractLightweight markdown negotiation
FreeInstant
2
AI EnhancedAI-powered HTML conversion
Free~500ms
3
Deep RenderFull headless browser rendering
Free~2-5s
4
Fallback ParseDOM parse — last resort
Free~200ms

Each layer is tried in order. The first one to return >200 chars of content wins. If a layer fails, the next one kicks in automatically.

Request Headers

Header
Values
Default
X-Return-Format
markdown, html, text, json, screenshot
markdown
X-Target-Selector
CSS selector
—
X-Wait-For-Selector
CSS selector
—
X-Remove-Selector
CSS selector (e.g. nav, footer, .ads)
—
X-With-Links-Summary
none / all / dedup
none
X-With-Images-Summary
none / all / dedup
none
X-AI-Image-Description-Language
en / it / de / es / fr / pt
—
X-AI-HTML-Hostname
hostname (e.g. docs.example.com)
source host
X-AI-PDF-Metadata
true / false
false
X-Retain-Images
all / none
all
X-Token-Budget
number (min 100)
—
X-Md-Link-Style
inline / referenced / discarded
inline
X-Engine
auto / browser / direct
auto
X-Viewport-Width
number (pixels)
1280
X-Viewport-Height
number (pixels)
720
X-Set-Cookie
cookie string
—
X-Timeout
5-60 (seconds)
30

Example URLs

Basic conversion

https://md.yolopush.com/https://example.com

JSON response

Target URL with query params

https://md.yolopush.com/https://example.com?page=2&sort=name

Remove nav & footer

Direct mode (fast)

Strip all images

Response Headers

X-ProviderWhich extraction layer produced the result (e.g. quick-extract, ai-enhanced, deep-render)
X-Duration-MsTime taken to scrape the URL in milliseconds
X-Markdown-TokensEstimated token count of the markdown output

cURL Examples

Get markdown
curl https://md.yolopush.com/https://example.com
JSON response
curl -H "Accept: application/json" https://md.yolopush.com/https://example.com
Screenshot (PNG)
curl -o screenshot.png "https://md.yolopush.com/https://example.com?format=screenshot"
Remove nav & footer
curl -H "X-Remove-Selector: nav, footer, .sidebar" https://md.yolopush.com/https://example.com
Dedup links summary
curl -H "X-With-Links-Summary: dedup" https://md.yolopush.com/https://example.com
Disable PDF metadata
curl -H "X-AI-PDF-Metadata: false" https://md.yolopush.com/https://example.com/report.pdf
Direct mode (fast)
curl "https://md.yolopush.com/https://example.com?engine=direct"