# webfetch

> Give your agents access to the web. One request returns clean content from any URL — markdown, HTML,
> text, links, images, metadata or a screenshot — rendered by a real browser with bot challenges handled.
> Every failure is reported honestly and charged 0 credits. The API is paid; the playground is free.

## Start here

- [Full agent reference](https://webfetch.run/elements-full.txt): every field, format, price and error code.
- [Compact briefing](https://webfetch.run/elements.txt): one screen, enough for a first correct call.
- [Machine-readable JSON](https://webfetch.run/agent.json): the same contract, parseable.
- [Docs](https://webfetch.run/docs): human-readable reference.
- [Pricing](https://webfetch.run/pricing): credit cost per tier, and why a failure is free.

## Endpoint

  POST https://api.webfetch.run/v1/scrape
  Authorization: Bearer sk_live_...
  Content-Type: application/json

  {"url": "https://example.com", "formats": ["markdown"]}

## Notes for agents

- `success: false` always means no content. `blocked` is an HTTP 200, so check the field.
- A wall or error costs 0 credits.
- Reusing `metadata.session` as `session` makes repeat queries to one host roughly 5x faster.