Publish HTML Pages with the RunThis.page API
The RunThis.page REST API lets you create, update, and manage hosted HTML pages programmatically. Automate publishing from CI/CD pipelines, scripts, or AI tools with a simple API call.
API access is available on Pro ($30/mo) and Business ($50/mo) plans. Generate an API key from your Settings page, and you're ready to publish.
Using Claude Desktop? The MCP server lets Claude publish pages directly from your conversation — no code needed.
Step-by-step: Publish via API
-
1
Get your API key
Go to Settings in your dashboard and create an API key. Copy it immediately — it's only shown once.
-
2
POST your HTML
Send your HTML content to
/api/v1/pageswith your API key in the Authorization header.curl -X POST https://runthis.page/api/v1/pages \ -H "Authorization: Bearer rtp_your_key_here" \ -H "Content-Type: text/html" \ -H "X-Page-Title: My Dashboard" \ -d '<html><body><h1>Hello World</h1></body></html>' -
3
Get your live URL
The API returns a JSON response with your page's unique URL. It's live immediately on a global CDN.
{"page_id": "a1b2c3d4e5", "url": "https://p-a1b2c3d4e5.pages.runthis.page", ...}
Update an existing page
To update a page's HTML content, use PUT with the page ID. The URL stays the same.
curl -X PUT https://runthis.page/api/v1/pages/a1b2c3d4e5 \
-H "Authorization: Bearer rtp_your_key_here" \
-H "Content-Type: text/html" \
-d @updated_report.htmlPython example
import requests
resp = requests.post(
"https://runthis.page/api/v1/pages",
headers={
"Authorization": "Bearer rtp_your_key_here",
"Content-Type": "text/html",
"X-Page-Title": "Weekly Report",
},
data=open("report.html", "rb").read(),
)
print(resp.json()["url"])Use cases
- CI/CD deploys — Publish build reports, test results, or documentation on every push
- AI tool integration — Let AI agents create and publish HTML pages via MCP or the REST API
- Batch publishing — Generate and publish dozens of pages from a script
- Automated reporting — Schedule daily or weekly HTML reports from data pipelines
Why RunThis.page for API publishing?
- ✓ Simple REST API — one POST to create a page, one PUT to update it. No SDKs required.
- ✓ Instant URLs — pages are live on a global CDN immediately after upload.
- ✓ Plan limit enforcement — the API respects your plan's page count and file size limits.
- ✓ Full management — create, update, delete, set passwords, and read analytics via the API.
Also works great for publishing Claude artifacts, ChatGPT outputs, and data dashboards programmatically. For a zero-code approach, try publishing directly from Claude Desktop with MCP.
Ready to share your HTML?
Upload your file and get a shareable link in seconds.
Get StartedPlans start at $15/mo. See pricing