Changelog · July 2, 2026

Request caching with max_age

Ask for the same page twice and pay once.

By Roger Campos · Last updated: July 2026

TL;DR

Every successful result is now stored, and an identical request inside your freshness window is answered from it instead of visiting the page again. max_age sets that window — "2 hours", "3 days" or seconds — defaulting to 7 days and capped at 30. Cache hits are free and are never refused for quota; max_age: 0 always fetches fresh.

Start free See the API

Free plan, no credit card. 1,000 credits a month.

Identical means the same operation, the same normalized URL and the same options. A hit is served in milliseconds and spends nothing. max_age: 0 skips the lookup and fetches the page again, and still stores the fresh result for later requests.

Accept a result up to 2 hours old

curl -X POST https://urlpipe.dev/markdown \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "max_age": "2 hours", "sync": true}'

Stored results are kept for 30 days and belong to the organization that asked for them.

Caching docs

Endpoints