curl -X POST https://api.peel.sh/v1/marketplace/kd74n2353r515czbkq7kaet9tx8jctwy/endpoints/front_page_stories:call -H "Content-Type: application/json" -d '{}' returns the Hacker News front page as typed JSON. See Call without an account.
How Peel works
- Build once, with models. A build-time compiler investigates the site with HTTP and a browser, writes one JavaScript program per endpoint, and tests it. Models run only during the build.
- Verify, then publish. Peel publishes an immutable version only when the exact program passes its declared examples and source-variation checks, and an independent reviewer can block publication. A failed build keeps structured diagnostics instead of publishing a misleading API.
- Call it forever without a model. A saved call runs the published program in a sandbox over HTTP or a guarded browser. It makes no model calls, plans nothing and never switches strategy.
- Actions need exact confirmation. A write runs only after you confirm the exact operation, input and outbound requests. Peel never repeats a write whose outcome it cannot confirm.
Where to call it
Core routes
Every operation on an existing API keeps the same
api.id, so callers do not migrate after a revision or rebuild.
Not available yet
These are not released, or not proven in production. Do not build against them.Read these docs from an agent
Request and response schemas for every route are in the API Reference tab, generated from
openapi.json.
Next steps
Quickstart
Build, inspect and call your first API over REST.
Core concepts
APIs, versions, endpoints and the build lifecycle.
MCP server
Connect Claude Code, Cursor, Codex or any MCP client.
Errors
Error codes and what to do about each.