Read webpage
read_webpageClean article Markdown. Use it when the page is long or cluttered. Skip it on a short or already clean page: the quote compares the tokens both ways and does not charge for that check. Savings are compared with the page's visible text, not its HTML. One all-in price (6 sats). Blocked calls are credited.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public http or https page. | |
| meta | No | Off by default. Set true to include finalUrl, canonical, byline, wordCount, fetchedAt, and totalLength. Title, url, markdown, and published are always returned. published is the page date, or null. | |
| mode | No | article drops images, link URLs, citations and reference lists. full keeps them. | article |
| max_sats | No | Most this call may charge. Minimum 1. A higher total charges nothing. | |
| max_chars | No | Optional cap on the Markdown. The maximum is 200000 characters. (minimum 500). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | approval_required, limit_exceeded, or insufficient_balance when the call stopped. | |
| which | No | Which limit: per_call, per_day, per_session, per_hour_buys, per_minute_calls, or per_minute_sats. | |
| content | No | Delivered text. Empty when the call did not deliver. | |
| message | No | ||
| order_id | No | Order id after a charge. Null when nothing was charged. | |
| truncated | No | True when the source was longer than content, or the page itself was cut. | |
| total_cost | No | All-in price string. | |
| approval_url | No | Page where the person approves this exact price. | |
| balance_sats | No | Credit balance after the call, or null when it was not read. | |
| sats_charged | No | Sats charged for this call. 0 when nothing was charged. | |
| total_length | No | Characters before truncation. Larger than content_length when truncated is true. | |
| content_length | No | Characters in content. |